cogview-image-gen

name	cogview-image-gen
description	智谱 CogView-4 文生图技能。支持中英双语提示词，支持汉字生成，可自定义分辨率。通过智谱开放平台 API 调用。

CogView-4 文生图技能

基于智谱 AI CogView-4 模型的文生图能力。支持中英双语输入，原生中文语义理解，能在图片中生成汉字。

模型信息

• 模型名称： CogView-4
• 参数量： 60 亿
• 输入： 中英双语文本提示词
• 输出： 图片（默认 1024×1024）
• 价格： ~0.1 元/张
• 特点： 支持图片中生成中文字符

API 配置

API Key 从 OpenClaw 配置文件中自动读取（与 GLM 模型共用同一个 Key）：

# 配置文件路径
~/.openclaw/openclaw.json

# Key 路径
models.providers.qtcool.apiKey

无需额外配置环境变量。

使用方式

方式一：直接调用 API（推荐）

使用 exec 工具执行 shell 命令调用脚本：

# 基础用法
bash skills/cogview-image-gen/scripts/generate.sh "一只可爱的橘猫" output.png

# 指定分辨率
bash skills/cogview-image-gen/scripts/generate.sh "山水画风格" output.png --size 768x1344

# 指定保存目录
bash skills/cogview-image-gen/scripts/generate.sh "城市夜景" /tmp/my-image.png

方式二：curl 直接调用

# 读取 API Key 并调用
API_KEY=$(python3 -c "import json; print(json.load(open('$HOME/.openclaw/openclaw.json'))['models']['providers']['qtcool']['apiKey'])")

curl -s --max-time 120 \
  "https://open.bigmodel.cn/api/paas/v4/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "cogview-4",
    "prompt": "你的提示词",
    "size": "1024x1024"
  }'

支持的分辨率

尺寸	比例	适用场景
1024×1024	1:1	通用、头像、社交媒体
768×1344	9:16	手机壁纸、海报
864×1152	3:4	竖版海报
1344×768	16:9	横版海报、封面
1152×864	4:3	PPT 封面、文档配图
1440×720	2:1	横幅、Banner

提示词技巧

1. 中文优先： CogView-4 对中文理解最好，建议用中文描述
2. 风格明确： 加上风格关键词（水彩画、油画、3D 渲染、扁平设计等）
3. 细节丰富： 描述越具体，生成效果越好
4. 负面提示： 暂不支持 negative_prompt
5. 中文文字： 直接在 prompt 中写要生成的文字内容

错误处理

错误	原因	解决
余额不足	账户没额度	去 open.bigmodel.cn 充值
模型不存在	API 地址错误	检查 endpoint
请求超时	网络问题	检查服务器网络
图片下载失败	URL 过期	重新生成（URL 有效期 1 小时）

图片发送到飞书

生成图片后，使用 message 工具发送：

message(action=send, media="/path/to/image.png", message="描述文字")

生成后清理

图片默认保存到 workspace/media/generated/ 目录。定期清理旧文件：

# 清理 7 天前的生成图片
find workspace/media/generated/ -name "*.png" -mtime +7 -delete