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 包装/品牌图