Growth Studio OpenAPI Integration Guide · 爆款复刻

Create a Viral Clone Task

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.

Request

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.

cURL

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"
    }
  }'

Task Parameters

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:

Product Parameters

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: