Skip to main content

​
概述

可控文生音效（timing2audio）用于基于时间轴生成多段音效事件，支持多个事件重叠。该能力仅生成音效，不支持输出背景音乐（BGM）。
[!NOTE]
  • 本平台接口：POST https://models.kapon.cloud/vidu/ent/v2/timing2audio
  • 官方接口：POST https://api.vidu.cn/ent/v2/timing2audio

​
请求参数

参数类型必填说明
modelstring✅模型名：audio1.0
durationfloat❌音频时长，默认 10，范围 2–10 秒
timing_promptsarray✅音效事件数组
seedint❌随机种子
callback_urlstring❌回调地址

​
timing_prompts 事件字段

字段类型必填说明
fromfloat✅事件起始时间（秒）
tofloat✅事件结束时间（秒）
promptstring✅事件描述，单条提示词 ≤ 1500 字符
[!IMPORTANT] from 与 to 必须在 [0, duration] 区间内，且 from < to。

​
示例

curl -X POST "https://models.kapon.cloud/vidu/ent/v2/timing2audio" \
  -H "Authorization: Bearer <kapon Token>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "audio1.0",
    "duration": 10,
    "timing_prompts": [
      {
        "from": 0.0,
        "to": 3.0,
        "prompt": "清晨的鸟叫声"
      },
      {
        "from": 3.0,
        "to": 6.0,
        "prompt": "远处传来火车驶过的声音"
      },
      {
        "from": 5.0,
        "to": 9.5,
        "prompt": "海浪轻轻拍打沙滩"
      }
    ],
    "seed": 0
  }'

​
返回示例

{
  "task_id": "your_task_id_here",
  "state": "created",
  "model": "audio1.0",
  "duration": 10,
  "timing_prompts": [
    {
      "from": 0.0,
      "to": 3.0,
      "prompt": "清晨的鸟叫声"
    }
  ],
  "seed": 0,
  "credits": 0,
  "created_at": "2025-01-01T10:00:00.000Z"
}

​
查询结果

任务创建成功后，通过 任务查询 接口获取最终结果。