该接口可以根据时间轴控制音效生成。

请求信息

请求 URL

POST /hub/vidu/v2/timing2audio

请求头

Header	必填	示例值
Authorization	是	Bearer sk-xxxxx
Content-Type	是	application/json; charset=utf-8

请求体

字段	类型	必填	说明
model	string	是	模型名称，当前常见值为 audio1.0
- timing_prompts	object[]	是	时间轴音效数组。支持多个事件重叠，单个事件提示词常见上限为 1500 字符
prompt	string	是	单个事件的音效描述
from	float	是	开始时间，需位于 [0, duration] 区间
to	float	是	结束时间，需位于 [0, duration] 区间，且不早于 from
duration	float	否	音频总时长，默认通常为 10 秒，常见可选范围：2-10 秒
seed	int	否	随机种子。传 0 或不传时自动生成
callback_url	string	否	任务状态回调地址，具体规范请参考 。

请求示例

json{
  "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	string	任务 ID
state	string	任务状态。常见值：created、queueing、processing、success、failed
model	string	模型名称
duration	int	音频时长
timing_prompts	object[]	多个音效事件参数
seed	int	随机种子
credits	string	消耗量
created_at	string	创建时间

响应示例

json{
  "task_id": "tsk_1234567902",
  "state": "created",
  "model": "audio1.0",
  "duration": 10,
  "timing_prompts": [
    {
      "from": 0.0,
      "to": 3.0,
      "prompt": "清晨的鸟叫声"
    },
    {
      "from": 3.0,
      "to": 6.0,
      "prompt": "远处传来火车驶过的声音"
    }
  ],
  "seed": 55667788,
  "credits": "4.000000",
  "created_at": "2026-04-16T09:42:00Z"
}

错误码

完整列表请参考客户端 API 错误码。