| name | clawec-image-create |
| description | 通过 ClawEC API 进行 AI 图片生成，支持选择模型/比例/分辨率、上传参考图、提交生成任务并查询结果。在用户需要 AI 生图、文生图、图生图、电商素材出图、参考图生成时使用。 |
AI 图片生成
关于 ClawEC
ClawEC 是一款面向跨境电商场景的 AI 智能体协同平台，以「你的跨境电商 AI 团队」为品牌主张，将选品、调研、运营、上架、营销、客服、采购、合规等环节沉淀为可执行的 SOP（标准作业程序），通过多智能体（「虾员工」）分工协作与 7×24 小时自动化任务，帮助卖家在单人或少人条件下完成跨境业务闭环，降低对专业运营团队与复杂本地部署的依赖。
本技能调用 ClawEC 图片生成 API（与 Web 端 image-create 页面一致），完成模型选型、参考图上传、提交生成与结果查询。
认证与基址
优先从环境变量 CLAWEC_TOKEN 或 CLAWEC_API_KEY 读取；未设置时向用户索取，勿硬编码。
注意：图片生成接口使用 Token 请求头，与 /aigc/tool/* 开放工具的 Authorization: Bearer 写法不同。
公共参数
Web 端所有请求会自动附带以下参数（GET 为 query，POST 为 body 字段）：
| 参数 | 说明 |
|---|
| platform | 平台标识，Web 端来自运行时配置 |
| terminal | 终端类型，Web 端固定 4 |
| flag | 业务标识，Web 端来自运行时配置 |
| language | 语言，如 zh-CN |
脚本中可使用默认值：platform=1&terminal=4&language=zh-CN（上传接口同理）。
完整流程
1. GET /aigc/ec_media/image/create/dic → 获取 models / ratios / sizes
2. POST /upload/image → 上传参考图（可选，最多 12 张）
3. POST /aigc/ec_media/image/create → 提交生成任务
4. GET /aigc/ec_media/image/create/logs → 轮询生成结果
生成通常为异步任务；提交成功后需轮询日志接口，直到对应记录的 urls 非空或 fail=true。
1. 获取模型列表（字典）
GET /aigc/ec_media/image/create/dic
返回可选的 模型、比例、分辨率 三组字典，提交生成时需使用其中的 id 字段。
调用
curl -s -G "https://www.clawec.com/api/aigc/ec_media/image/create/dic" \
-H "Token: $CLAWEC_TOKEN" \
--data-urlencode "platform=1" \
--data-urlencode "terminal=4" \
--data-urlencode "language=zh-CN"
或使用脚本：
bash scripts/dic.sh
响应 data 结构
| 字段 | 类型 | 说明 |
|---|
| models | array | 生成模型列表 |
| ratios | array | 画面比例列表，默认选第一个 |
| sizes | array | 分辨率列表，默认选第一个 |
models 元素（TypeRespString + 扩展字段）
| 字段 | 说明 |
|---|
| id | 模型 ID，提交 model 时使用 |
| title | 展示名称 |
| point | 每张图消耗积分（可选） |
| level | 所需会员等级（可选） |
| levelText | 等级展示文案（可选） |
ratios / sizes 元素
| 字段 | 说明 |
|---|
| id | 提交 ratio / size 时使用 |
| title | 展示名称，如 16:9、2K |
2. 上传参考图
POST /upload/image
multipart/form-data 上传本地图片，返回可访问 URL，再填入生成请求的 images 数组。
| 参数 | 位置 | 必填 | 说明 |
|---|
| file | form | 是 | 图片文件 |
| platform | form | 是 | 如 1 |
| terminal | form | 是 | 如 4 |
| language | form | 否 | 如 zh-CN |
限制（与 Web 端一致）：
- 仅支持
image/*
- 单次生成最多 12 张参考图
- 返回
data.url 或 data.path；若为相对路径需拼接 Base URL
调用
curl -s -X POST "https://www.clawec.com/api/upload/image" \
-H "Token: $CLAWEC_TOKEN" \
-F "file=@/path/to/reference.jpg" \
-F "platform=1" \
-F "terminal=4" \
-F "language=zh-CN"
或使用脚本：
bash scripts/upload.sh /path/to/reference.jpg
响应 data 示例
{
"url": "https://cdn.example.com/xxx.jpg"
}
3. 提交图片生成
POST /aigc/ec_media/image/create
| 参数 | 位置 | 必填 | 说明 |
|---|
| prompt | body | 是 | 提示词 |
| model | body | 否 | 模型 ID，来自 dic.models[].id |
| ratio | body | 否 | 比例 ID，来自 dic.ratios[].id |
| size | body | 否 | 分辨率 ID，来自 dic.sizes[].id |
| images | body | 否 | 参考图 URL 数组，来自上传接口 |
提示词中可引用参考图：上传后按顺序称为 [图1]、[图2] …，例如：将[图1]中的产品放入白色背景。
调用
curl -s -X POST "https://www.clawec.com/api/aigc/ec_media/image/create" \
-H "Token: $CLAWEC_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"prompt": "一只可爱的橙色猫咪，产品摄影风格",
"model": "MODEL_ID",
"ratio": "RATIO_ID",
"size": "SIZE_ID",
"images": ["https://cdn.example.com/ref.jpg"],
"platform": 1,
"terminal": 4,
"language": "zh-CN"
}'
或使用脚本：
bash scripts/create.sh \
--prompt "一只可爱的橙色猫咪" \
--model MODEL_ID \
--ratio RATIO_ID \
--size SIZE_ID \
--images '["https://cdn.example.com/ref.jpg"]'
提交成功返回 status: 1；data 通常为空对象，实际图片在日志接口中获取。
4. 获取生成结果
GET /aigc/ec_media/image/create/logs
| 参数 | 位置 | 必填 | 说明 |
|---|
| start | query | 否 | 分页索引，从 1 开始，默认 1 |
| size | query | 否 | 每页条数，Web 端默认 5 |
调用
curl -s -G "https://www.clawec.com/api/aigc/ec_media/image/create/logs" \
-H "Token: $CLAWEC_TOKEN" \
--data-urlencode "start=1" \
--data-urlencode "size=5" \
--data-urlencode "platform=1" \
--data-urlencode "terminal=4" \
--data-urlencode "language=zh-CN"
或使用脚本：
bash scripts/logs.sh 1 5
响应 data 结构
| 字段 | 说明 |
|---|
| count | 总记录数 |
| more | 1 = 还有下一页，0 = 无更多 |
| start | 下一页索引 |
| items | 生成记录数组 |
items 元素（ImageResultV2）
| 字段 | 说明 |
|---|
| id | 记录 ID |
| urls | 生成的图片 URL 数组；生成中时可能为空 |
| fail | true 表示生成失败 |
| param | 原始参数（prompt / model / ratio / size / images） |
| time | 创建时间字符串 |
轮询建议
- 提交生成后立即请求
logs?start=1&size=5
- 取最新一条（或匹配 prompt 的记录），检查
urls 与 fail
- 若
urls 仍为空且 fail 不为 true，等待 3–5 秒后重试
- Web 端亦通过 WebSocket
wss://www.clawec.com/api/aigc/socket 接收 image_result_refresh 推送；脚本场景用轮询即可
删除记录（可选）
GET /aigc/ec_media/image/log/delete?id=<记录ID>
响应 envelope
所有接口统一外层结构：
{
"status": 1,
"code": 200,
"msg": "success",
"data": { ... },
"pointInfo": { "type": 0, "point": 0 }
}
status: 1 = 成功，0 = 失败code: 业务码；2001 = 未登录/Token 无效，2002 = 积分不足data: 业务数据（http 封装层通常直接返回此字段）pointInfo: 积分消耗信息
完整字段说明见 references/response-schema.md。
工作流程
- 确认用户提示词、是否需要参考图
- 检查
CLAWEC_TOKEN 或 CLAWEC_API_KEY
- 调用 dic 获取 model / ratio / size，按用户需求或默认选第一项
- 若有参考图，逐个调用 upload 获取 URL
- 调用 create 提交任务
- 轮询 logs 直到拿到
urls 或确认 fail
- 向用户展示图片链接与所用参数；失败时说明原因并建议调整提示词或积分充值
输出建议
默认中文摘要，包含：
- 使用的模型、比例、分辨率（展示 title，附 id）
- 提示词与参考图数量
- 生成结果：图片 URL 列表；失败时给出
fail 说明
- 积分消耗（若
pointInfo 或模型 point 有值）
示例
输入：生成一张「白色背景上的无线耳机产品图」，参考我上传的耳机照片
步骤：
dic.sh → 选定 model=flux-pro, ratio=1:1, size=2Kupload.sh ref.jpg → https://cdn.../ref.jpgcreate.sh --prompt "白色背景产品摄影，无线耳机，柔和布光" --model flux-pro --ratio 1:1 --size 2K --images '["https://cdn.../ref.jpg"]'logs.sh 轮询 → 返回 urls: ["https://cdn.../output.png"]
输出摘要：
