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"
  }'
合成任务提交后,可继续使用 查询任务结果查询子任务列表 接口跟踪状态。