메뉴
电商商品图生成. 用图盾·工坊 (Tudun Workshop) 同步 API 一键产出主图 / 卖点图 / 促销图 / 详情图. 适用场景: 用户给一张产品照片, 要求生成「白底主图」「N 张卖点图」「618/双11 促销图」「淘宝/京东/拼多多详情页」. 触发关键词: 商品主图, 白底图, 卖点图, 促销图, 详情图, 电商图, 产品图, 淘宝图, 拼多多详情, 京东详情. E-commerce product image generation for Taobao/JD/Pinduoduo/Tmall sellers.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | tudun-image-generation |
| description | 电商商品图生成. 用图盾·工坊 (Tudun Workshop) 同步 API 一键产出主图 / 卖点图 / 促销图 / 详情图. 适用场景: 用户给一张产品照片, 要求生成「白底主图」「N 张卖点图」「618/双11 促销图」「淘宝/京东/拼多多详情页」. 触发关键词: 商品主图, 白底图, 卖点图, 促销图, 详情图, 电商图, 产品图, 淘宝图, 拼多多详情, 京东详情. E-commerce product image generation for Taobao/JD/Pinduoduo/Tmall sellers. |
| license | complete |
把产品照变成 4 类电商图: 主图 / 卖点图 / 促销图 / 详情图.
用户提了产品图 (商品照片 URL 或上传) 且 提到下面任一情况:
如果用户只是要修图 / 一般 AI 绘图 / 非电商场景, 不要用此 skill.
tdgz_live_xxxxxxxx)如果用户还没账号, 引导他先注册再回来.
API 基地址: https://image.bjaydmy.com
鉴权: Authorization: Bearer tdgz_live_xxx
POST /api/v1/images/generations
请求体:
{
"image_url": "https://公网可访问的原图.jpg",
"workflow": "main-image",
"prompt": "可选, 整体方向",
"prompts": ["可选, 数组每张独立", "..."],
"negative_prompt": "可选, 反向约束",
"n": 4,
"platform_profile": "taobao"
}
30~120 秒内返回:
{
"id": "gen-xxx",
"credits_used": 4,
"credits_remaining": 96,
"workflow": "selling-points",
"data": [
{ "url": "https://image.bjaydmy.com/api/v1/files/<token>", "expires_at": 1716710400 }
]
}
签名 URL 24h 内有效, 用户点开就能看图.
GET /api/v1/account → { credits_remaining, license_status, ... }
如果 credits_remaining 不够本次预计扣点数, 先告诉用户去充值, 不要硬调.
| workflow | 出图数 | 适用 | 扣点 |
|---|---|---|---|
main-image | 1 | 白底主图, 第一张电商展示图 | 1 |
selling-points | 4 (默认) | 多张卖点海报, 围绕产品优势 | =出图数 |
promotion-images | 1 | 促销主视觉, 带主标语 / 价格 | 1 |
detail-images | 4 (默认) | 详情页长图, 按平台规格 | =出图数 |
单 prompt (整体方向, 框架自动 split):
{ "workflow": "selling-points", "prompt": "突出轻薄、防水、便携三大卖点, 蓝白配色" }
prompts 数组 (每张独立, 数组长度 = 出图数):
{ "workflow": "selling-points", "prompts": [
"突出『轻薄』, 主标语「仅 8mm 厚」, 正侧面对比构图",
"突出『防水』, 水滴溅射特写, IP68 标识居右下",
"突出『长续航』, 电池图标 + 30 天文案"
] }
两者互斥, 同时传返 400.
platform_profile: taobao (默认) / tmall / jd / pdd. 框架按平台规格自动注入图片尺寸和质量约束.
agent 调用失败时按 code 分类处理:
| code | 怎么办 |
|---|---|
AUTH | 提示用户检查密钥 (可能没复制全 / 被吊销) |
INSUFFICIENT_CREDIT | 提示用户去充值, 不要硬重试 |
RATE-LIMIT | 等 Retry-After 头给的秒数再试 |
IMG-FORMAT | 输入 image_url 不可访问 / 不是图片 / 私有 IP. 让用户换个 URL |
IMG-TOO-LARGE | 输入图 > 20MB. 让用户压缩 |
NET-TIMEOUT | 生成超时 (>120s). 积分自动退还, 可以重试. 失败 3 次告诉用户报障 |
MODERATION-REJECT | 内容审核拒绝. 让用户换图或调 prompt 避开敏感词 |
IDEMPOTENCY-CONFLICT | 用了相同 Idempotency-Key 但请求体不同. 换个新 key |
PROVIDER-ERROR | 上游模型故障. 等几秒重试 |
KEY='tdgz_live_xxxxxxxxxxxxxxxx'
# 1. 单张主图
curl -s -X POST https://image.bjaydmy.com/api/v1/images/generations \
-H "Authorization: Bearer $KEY" \
-H "Content-Type: application/json" \
-d '{ "image_url": "https://example.com/product.jpg", "workflow": "main-image" }'
# 2. 3 张卖点图, 每张独立 prompt
curl -s -X POST https://image.bjaydmy.com/api/v1/images/generations \
-H "Authorization: Bearer $KEY" \
-H "Content-Type: application/json" \
-d '{
"image_url": "https://example.com/product.jpg",
"workflow": "selling-points",
"prompts": [
"突出『轻薄』, 主标语「仅 8mm 厚」",
"突出『防水』, IP68 水滴特写",
"突出『长续航』, 电池 + 30 天文案"
]
}'
# 3. 拼多多详情图, 4 张, 整体冷色调
curl -s -X POST https://image.bjaydmy.com/api/v1/images/generations \
-H "Authorization: Bearer $KEY" \
-H "Content-Type: application/json" \
-d '{
"image_url": "https://example.com/product.jpg",
"workflow": "detail-images",
"platform_profile": "pdd",
"prompt": "冷色调高级感, 强调材质细节"
}'
agent 网络抖动重试容易重复扣费. 解决: 加 Idempotency-Key 头:
-H "Idempotency-Key: $(uuidgen)"
409 IDEMPOTENCY-CONFLICTimage_url 单图)中文: https://github.com/LmaoAgent/tudun-workshop/blob/main/docs/api-v1.md 英文: https://github.com/LmaoAgent/tudun-workshop/blob/main/docs/api-v1.en.md OpenAPI: https://image.bjaydmy.com/api/v1/openapi.json MCP server (Claude Desktop / Cherry Studio): https://image.bjaydmy.com/api/v1/mcp