Growth Studio OpenAPI Integration Guide · 商品套图
Generate product images from product information and reference images. Each request handles one product, one platform, and one marketplace/language combination, returning one task_id.
Each selected image_types value produces one image. The number of reference images does not determine the output count. For example, three references with main and lifestyle target two output images.
| Method | Path | Purpose |
|---|---|---|
POST |
/openapi/v1/product-suite/images/generations |
Create a product image suite |
GET |
/openapi/v1/product-suite/images/generations/{task_id} |
Retrieve task and per-image results |
GET |
/openapi/v1/images |
List the workspace image asset pool |
Taobao/Tmall, JD, Amazon, Walmart, and TikTok Shop are supported. Choose image purposes; do not specify a generation model, image size, or aspect ratio. All calls use the authentication described in Getting Started.
Send Content-Type: application/json with one JSON object, at most 1 MiB. Unknown fields, including fields inside nested objects, are rejected.
| Field | Type | Required | Description |
|---|---|---|---|
platform |
string | Yes | taobao_tmall, jd, amazon, walmart, or tiktok_shop |
marketplace |
string | For cross-border platforms | Amazon, Walmart, and TikTok Shop values from Product Image Suites (Marketplaces and Languages); omit for Taobao/Tmall and JD |
language |
string | For cross-border platforms | Must match the marketplace. Taobao/Tmall and JD accept only zh-CN, which is also their default |
quality |
string | No | Taobao/Tmall and JD only: standard (default) or pro; omit for other platforms |
product |
object | Yes | Product information below |
image_types |
string[] | Yes | At least one unique type, at most the supported type count for that marketplace; see Product Image Suites (Image Types) |
platform identifies the platform; marketplace selects a site within it. For example, amazon + amazon.co.jp + ja-JP generates Japanese content for Amazon Japan. Taobao/Tmall and JD allow omitted or empty marketplace; cross-border platforms allow omitted or empty quality. Nonempty values in those unsupported fields are rejected.
product field |
Type | Required | Description |
|---|---|---|---|
title |
string | Without source_url |
Up to 255 characters |
images |
object[] | Without source_url |
1–9 references, each containing only url |
images[].url |
string | For each image | Platform CDN URL returned by upload or from an existing platform asset |
description |
string | No | Up to 5,120 characters |
brand |
string | No | Up to 255 characters |
price |
object | No | Product display price, unrelated to generation charges |
price.amount |
string | With price |
Product price, for example "29.99" |
price.currency |
string | With price |
Three-letter currency code, for example "USD" |
source_url |
string | No | HTTP(S) product page URL, up to 2,048 characters; fills information not supplied manually |
Manually supplied references cannot use arbitrary external image URLs. Download external images and upload them through POST /openapi/v1/image/upload; see Images and System Avatars. Existing platform images can be reused. More than nine manual images are rejected. Product-page extraction uses at most nine references, with manually supplied images taking priority.
image_types and result images[].type use the same values. Results follow the canonical platform order below, regardless of request array order.
Taobao/Tmall: taobao_tmall, 10 types; standard / pro.
| Type | Purpose |
|---|---|
click |
Click-through image |
overview_detail |
Overview/detail |
scene |
Scene |
trust |
Trust |
white_background |
White background |
product_overview |
Product overview |
core_detail |
Core detail |
usage_scene |
Usage scene |
selling_point |
Selling point demonstration |
brand_vibe |
Brand atmosphere |
JD: jd, 9 types; standard / pro.
| Type | Purpose |
|---|---|
white_background |
White background |
selling_point |
Selling point |
multi_angle |
Multiple angles |
structure_function |
Structure/function |
scene |
Scene |
size_spec |
Dimensions/specifications |
material_detail |
Material detail |
package_contents |
Package contents |
transparent |
Transparent background |
Amazon: amazon, 9 types; omit quality.
| Type | Purpose |
|---|---|
main |
Main image |
angle |
Multiple angles |
structure |
Structure |
feature |
Feature/benefit |
lifestyle |
Lifestyle |
material |
Material |
dimensions |
Dimensions |
category |
Category supplement |
package_brand |
Packaging/brand |