Growth Studio OpenAPI接入文档 · Viral Clone

公网参考视频可先通过导入视频获得 video_id,再提交复刻任务。复刻创建返回 run_id,请使用本功能的爆款复刻(查询复刻任务)接口,不要将 run_id 作为统一视频详情的 video_id。

创建复刻任务

爆款复刻根据参考视频和商品信息,完成视频分析、脚本生成和视频生成。一次提交后,使用返回的 run_id 查询结果。

请求

POST /openapi/v1/viral-clone/runs
Content-Type: application/json
Authorization: Bearer <API_KEY>

创建任务是异步操作。返回 202 Accepted 表示任务已受理,不表示视频已经生成完成。请求体最大为 1 MiB。

cURL

请将 source_video_id 替换为当前工作空间中的参考视频 ID,将 listing.image_info.items[].url 替换为图片上传接口实际返回的 URL:

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": "zh-CN",
    "listing": {
      "title": "轻便跑鞋",
      "description": "透气轻便,适合日常训练。",
      "brand": "Example Brand",
      "image_info": {
        "items": [
          {
            "url": "REPLACE_WITH_UPLOADED_PRODUCT_URL",
            "sort": 0
          }
        ]
      }
    },
    "video": {
      "aspect_ratio": "9:16",
      "resolution": "720p",
      "language": "zh-CN"
    },
    "avatar": {
      "mode": "disabled"
    }
  }'

任务参数

字段 类型 必填 说明
source_video_id string 是 当前工作空间中的参考视频 ID,按十进制字符串传入
model string 是 standard、plus 或 pro,区分大小写
script_language string 是 脚本说明语言,使用 BCP 47 语言代码,例如 zh-CN、en-US

参考视频要求:

商品参数

字段 类型 必填 说明
listing object 是 商品信息
listing.listing_id string 否 当前工作空间中已有的商品 ID
listing.title string 条件必填 未传 listing_id 时必填,最长 255 个字符
listing.description string 否 商品描述,最长 5120 个字符
listing.brand string 否 品牌,最长 255 个字符
listing.image_info object 条件必填 未传 listing_id 时必填
listing.image_info.items array 条件必填 未传 listing_id 时必填;1~10 张商品图片,同时受所选档位参考图片上限限制
listing.image_info.items[].url string 是 商品图片完整 URL
listing.image_info.items[].sort integer 否 图片按该值升序排列,默认为 0;相同值按数组顺序使用

商品和图片规则: