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 |
参考视频要求:
video_id 作为 source_video_id。商品参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
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;相同值按数组顺序使用 |
商品和图片规则:
listing_id 时,使用该商品已保存的标题、描述、品牌和图片,其他商品字段不生效。已有商品同样需要有效标题和图片。