Growth Studio OpenAPI Integration Guide · 爆款复刻
Viral Clone analyzes a reference video, generates a script, and creates a video using the supplied product information. Submit one request and use the returned run_id to query the result.
POST /openapi/v1/viral-clone/runs
Content-Type: application/json
Authorization: Bearer <API_KEY>
Task creation is asynchronous. A 202 Accepted response means the task was accepted; it does not mean the video has finished generating. The maximum request body size is 1 MiB.
Replace source_video_id with a reference video ID from the current workspace, and replace listing.image_info.items[].url with the actual URL returned by the image upload endpoint:
curl --request POST \
"${BASE_URL}/openapi/v1/viral-clone/runs" \
--header "Authorization: Bearer ${API_KEY}" \
--header 'Content-Type: application/json' \
--data-raw '{
"source_video_id": "627410861853514291",
"model": "plus",
"script_language": "en-US",
"listing": {
"title": "Lightweight Running Shoes",
"description": "Breathable running shoes suitable for daily training.",
"brand": "Example Brand",
"image_info": {
"items": [
{
"url": "REPLACE_WITH_UPLOADED_PRODUCT_URL",
"sort": 0
}
]
}
},
"video": {
"aspect_ratio": "9:16",
"resolution": "720p",
"language": "en-US"
},
"avatar": {
"mode": "disabled"
}
}'
| Field | Type | Required | Description |
|---|---|---|---|
source_video_id |
string | Yes | Reference video ID in the current workspace; use a decimal string |
model |
string | Yes | standard, plus, or pro; case-sensitive |
script_language |
string | Yes | Language for script descriptions; use a BCP 47 code such as en-US or zh-CN |
Reference video requirements:
video_id as source_video_id.| Field | Type | Required | Description |
|---|---|---|---|
listing |
object | Yes | Product information |
listing.listing_id |
string | No | Existing product ID in the current workspace |
listing.title |
string | Conditionally required | Required when listing_id is omitted; maximum 255 characters |
listing.description |
string | No | Product description; maximum 5,120 characters |
listing.brand |
string | No | Brand; maximum 255 characters |
listing.image_info |
object | Conditionally required | Required when listing_id is omitted |
listing.image_info.items |
array | Conditionally required | Required when listing_id is omitted; 1–10 product images, subject to the selected tier's reference image limit |
listing.image_info.items[].url |
string | Yes | Complete product image URL |
listing.image_info.items[].sort |
integer | No | Ascending image order; defaults to 0. Equal values preserve array order |
Product and image rules:
listing_id is provided, the saved product title, description, brand, and images are used. Other submitted product fields are ignored. The product must have a valid title and images.listing_id returns INVALID_REQUEST.