Growth Studio OpenAPI Integration Guide · 商品套图

Workflow

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.

Creation Parameters

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

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