Vidu 可控文生音效

认证

authorization string 必填

所有 API 均使用 Bearer Token 鉴权

获取 API Key：

访问 API Key 管理页面 获取 API Key

用法：

将以下 Header 添加到请求中：

Authorization: Bearer YOUR_API_KEY

参数

model string 必填

请求使用的客户模型 ID。

值: vidu-cn-timing2audio-audio1.0

---

model string 必填

上游音频模型值，固定使用 audio1.0。

---

prompt string 必填

带时间控制的音效文本描述。

---

duration integer

音频时长。

---

seed integer

随机种子。

---

callback_url string

异步任务回调地址。

---

轮询

由于结果生成需要时间，您需要在创建任务后轮询任务状态

初始响应只返回任务 ID 和初始状态等信息，最终生成结果需通过使用该任务 ID 轮询任务状态接口获取

轮询请求与响应示例见右侧

响应格式

error object

错误信息，仅在状态为 failed 时存在。

code string

错误码

message string

详细错误信息

---

output array

生成结果，成功时存在。

content array

生成的资源内容列表

type string

资源类型。

值: audio

url string

生成资源 URL。文本类工具接口可能返回文本字段而不是 URL。

jobId string

上游任务 ID。

---

usage object

使用统计，成功时存在。

cost string

总费用（美元）。

discount number

折扣金额。

---

metadata object

元数据信息。