所有请求均使用 JSON 字段名或表单字段名中的 snake_case。除特别说明外，字符串均使用 UTF-8 编码。
通用请求头
| 字段 | 必填 | 说明 |
|---|
Authorization | 是 | Bearer <PUBLIC_API_KEY>，成员级 Public API Key。 |
Content-Type | JSON 请求必填 | 使用 application/json。上传接口使用 multipart/form-data。 |
Idempotency-Key | 生图建议 | 客户端生成的唯一请求标识。相同 Key 和相同请求内容只会创建一次任务。 |
图片上传字段
| 字段 | 必填 | 类型 | 说明 |
|---|
file | 是 | 文件 | 商品图、参考图或遮罩图。支持 PNG、JPEG、WebP、GIF、AVIF，最大 30 MB。 |
上传成功后返回 id、url 和 expires_at。图片 URL 最长保存 3 天。
商品 AI 分析字段
| 字段 | 必填 | 类型 | 说明 |
|---|
image_urls | 是 | 字符串数组 | 商品图片 URL，至少 1 张，最多 8 张。 |
product_name | 否 | 字符串 | 客户已知的商品名称，用于辅助 AI 判断。 |
product_description | 否 | 字符串 | 客户补充的商品描述，最长 5000 个字符。 |
language | 否 | 字符串 | 输出语言，默认 zh-CN。 |
该接口同步返回商品定位、目标人群、核心卖点、类目、属性和待确认信息。
A+ AI 策划字段
| 字段 | 必填 | 类型 | 说明 |
|---|
product / product_description | 是 | 对象/字符串 | 商品分析结果或商品描述。 |
image_urls | 是 | 字符串数组 | 商品图片 URL，至少 1 张。 |
modules | 是 | 字符串数组 | 需要策划的 A+ 模块，例如 core。 |
platform | 否 | 字符串 | 销售平台，例如 Amazon。 |
market | 否 | 字符串 | 目标市场，例如 US。 |
language | 否 | 字符串 | 策划输出语言，默认 zh-CN。 |
生图字段
| 字段 | 必填 | 类型 | 说明 |
|---|
prompt | 是 | 字符串 | 生图要求，建议描述主体、场景、构图和风格。 |
image_urls | 否 | 字符串数组 | 参考图或商品图 URL。 |
size | 否 | 字符串 | 画布比例，例如 1:1、16:9，默认 auto。 |
resolution | 否 | 字符串 | 输出分辨率，可选 1k、2k、4k。 |
module_key | A+ 生图必填 | 字符串 | A+ 模块标识，例如 core。 |
target_size | A+ 生图建议 | 字符串 | 目标交付尺寸，例如 970x600。 |
platform | A+ 生图建议 | 字符串 | 目标平台。 |
market | A+ 生图建议 | 字符串 | 目标市场。 |
生图接口返回 task_id，不会同步等待图片完成。
任务查询字段
| 字段 | 说明 |
|---|
task_id | 生图提交接口返回的任务编号。 |
status | queued 排队中、processing 处理中、succeeded 成功、failed 失败、cancelled 已取消。 |
result.images | 成功后的图片列表。每项包含 asset_id、url 和 expires_at。 |
error | 失败时返回错误码和说明；成功时为 null。 |