Skip to main content

​
概述

电商一键成片（ad-one-click）将商品图/模特图快速生成完整广告视频，包含：
  • 自动生成分镜
  • 生成旁白与背景音乐
  • 合成最终成片
[!NOTE]
  • 本平台接口：POST https://models.kapon.cloud/vidu/ent/v2/ad-one-click
  • 官方接口：POST https://api.vidu.cn/ent/v2/ad-one-click，详见 官方 API 文档

​
创建成片任务

curl -X POST "https://models.kapon.cloud/vidu/ent/v2/ad-one-click" \
  -H "Authorization: Bearer <kapon Token>" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      "https://your.cdn.com/product-1.jpg",
      "https://your.cdn.com/product-2.jpg"
    ],
    "prompt": "简洁风格的商品展示广告，突出材质与质感。",
    "duration": 15,
    "aspect_ratio": "16:9",
    "language": "zh",
    "creative": false
  }'

​
请求参数

参数类型必填说明
imagesarray✅商品图 1–7 张（URL 或 Base64）
promptstring❌视频风格描述
durationint❌时长 8–60 秒，默认 15
aspect_ratiostring❌比例：1:1 / 16:9 / 9:16
languagestring❌语言：zh / en
creativebool❌是否生成创意片段

​
查询任务结果

curl -X GET "https://models.kapon.cloud/vidu/ent/v2/tasks/$TASK_ID/creations" \
  -H "Authorization: Bearer <kapon Token>"

​
查询子任务列表

curl -X GET "https://models.kapon.cloud/vidu/ent/v2/ad-one-click/$TASK_ID" \
  -H "Authorization: Bearer <kapon Token>"
返回包含：
  • storyboards：分镜任务与视频结果
  • narration_records：旁白任务
  • bgm_records：背景音乐任务
  • completed_creation_records：合成成片任务

​
编辑分镜/旁白/背景音乐

curl -X POST "https://models.kapon.cloud/vidu/ent/v2/ad-one-click/edit" \
  -H "Authorization: Bearer <kapon Token>" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_one_click_task_id": "YOUR_TASK_ID",
    "type": "generate_narration",
    "prompt": "这是一段简短的中文旁白，突出产品卖点。"
  }'
type 值说明额外参数
generate_narration重新生成旁白-
generate_bgm重新生成背景音乐-
generate_video重新生成分镜视频storyboard_video_index

​
合成成片

curl -X POST "https://models.kapon.cloud/vidu/ent/v2/ad-one-click/compose" \
  -H "Authorization: Bearer <kapon Token>" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_one_click_task_id": "YOUR_TASK_ID",
    "video_task_ids": ["VIDEO_TASK_ID_1", "VIDEO_TASK_ID_2"],
    "bgm_task_id": "BGM_TASK_ID",
    "narration_task_id": "NARRATION_TASK_ID"
  }'
合成任务提交后，可继续使用 查询任务结果 或 查询子任务列表 接口跟踪状态。