Growth Studio OpenAPI接入文档 · Product Image Suites
商品套图根据商品信息及参考图片,生成指定用途的商品图片。一次请求只处理一个商品、一个平台、一个站点语言组合,返回一个 task_id。
每选一种 image_types 生成一张图,参考图数量与输出张数无关。 例如上传 3 张参考图,选择 main 和 lifestyle,输出目标为 2 张图。
| 方法 | 路径 | 用途 |
|---|---|---|
POST |
/openapi/v1/product-suite/images/generations |
创建一套商品图 |
GET |
/openapi/v1/product-suite/images/generations/{task_id} |
查询任务及逐张图片结果 |
GET |
/openapi/v1/images |
查询 Workspace 图片素材池 |
本版支持淘宝/天猫、京东、Amazon、Walmart、TikTok Shop。调用方选择图片用途;无需指定生成模型、图片尺寸或比例。
请求使用 Content-Type: application/json,只接受一个 JSON 对象,请求体不超过 1 MiB。仅发送下表声明的字段,未知字段(包括嵌套对象内的字段)会返回参数错误。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
platform |
string | 是 | taobao_tmall、jd、amazon、walmart、tiktok_shop |
marketplace |
string | 跨境平台必填 | 目标站点;Amazon、Walmart、TikTok Shop 按 商品套图(站点与语言枚举)填写,淘宝/天猫、京东省略 |
language |
string | 跨境平台必填 | 图片文案语言,与站点匹配;淘宝/天猫、京东省略时为 zh-CN,仅接受 zh-CN |
quality |
string | 否 | 仅淘宝/天猫、京东支持:standard(默认)或 pro;其他平台省略 |
product |
object | 是 | 商品信息,字段见下表 |
image_types |
string[] | 是 | 至少选择一种,最多为该站点支持的类型数;不得重复,枚举见 商品套图(平台与图片用途) |
platform 是电商平台,marketplace 是平台内的目标站点。例如 amazon + amazon.co.jp + ja-JP 表示面向 Amazon 日本站生成日语商品图。国内平台 marketplace、跨境平台 quality 可省略或传空字符串,不能传非空值。
product 字段 |
类型 | 必填 | 说明 |
|---|---|---|---|
title |
string | 无 source_url 时必填 |
商品标题,最长 255 字符 |
images |
object[] | 无 source_url 时必填 |
1~9 张参考图,每项只包含 url |
images[].url |
string | 每项必填 | 平台 CDN URL,使用上传接口返回的 url 或已有平台图片素材地址 |
description |
string | 否 | 商品描述,最长 5120 字符 |
brand |
string | 否 | 品牌,最长 255 字符 |
price |
object | 否 | 商品售价展示信息,与图片生成费用无关 |
price.amount |
string | 传 price 时必填 |
商品售价,例如 "29.99" |
price.currency |
string | 传 price 时必填 |
三位币种代码,例如 "USD" |
source_url |
string | 否 | 商品详情页 HTTP(S) URL,最长 2048 字符;服务端获取并补充未提供的商品信息 |
手填参考图不接受任意外部图片链接;外部图片应先下载,再通过 POST /openapi/v1/image/upload 上传文件。已有平台图片可以直接复用。手填图片超过 9 张直接拒绝;通过 source_url 获取商品时最多使用 9 张参考图,手填图片优先。
image_types 和查询结果 images[].type 使用相同枚举。结果按下表的平台类型顺序排列,顺序不随请求数组变化。
淘宝/天猫:taobao_tmall,共 10 种,支持 standard / pro。
| 类型 | 用途 |
|---|---|
click |
点击图 |
overview_detail |
全貌/细节图 |
scene |
场景图 |
trust |
信任图 |
white_background |
白底图 |
product_overview |
商品全貌 |
core_detail |
核心细节 |
usage_scene |
使用场景 |
selling_point |
卖点演示 |
brand_vibe |
品牌氛围 |
京东:jd,共 9 种,支持 standard / pro。
| 类型 | 用途 |
|---|---|
white_background |
白底图 |
selling_point |
卖点图 |
multi_angle |
多角度图 |
structure_function |
结构/功能图 |
scene |
场景图 |
size_spec |
尺寸规格图 |
material_detail |
材质细节图 |
package_contents |
包装内容图 |
transparent |
透明背景图 |
Amazon:amazon,共 9 种,不传 quality。
| 类型 | 用途 |
|---|---|
main |
主图 |
angle |
多角度图 |
structure |
结构图 |
feature |
功能卖点图 |
lifestyle |
生活场景图 |
material |
材质图 |
dimensions |
尺寸图 |
category |
类目补充图 |
package_brand |
包装/品牌图 |