认证
authorization string 必填
所有 API 均使用 Bearer Token 鉴权
获取 API Key:
访问 API Key 管理页面 获取 API Key
用法:
将以下 Header 添加到请求中:
Authorization: Bearer YOUR_API_KEY
参数
model string 必填
请求使用的客户模型 ID。
值: vidu-cn-text2audio-audio1.0
model string 必填
上游音频模型值,固定使用 audio1.0。
prompt string 必填
生成音频的文本描述。
duration integer
音频时长,按 Vidu 音频模型支持范围填写。
seed integer
随机种子,不传或传 0 时使用随机种子。
callback_url string
异步任务回调地址。
轮询
由于结果生成需要时间,您需要在创建任务后轮询任务状态
初始响应只返回任务 ID 和初始状态等信息,最终生成结果需通过使用该任务 ID 轮询任务状态接口获取
轮询请求与响应示例见右侧
响应格式
error object
错误信息,仅在状态为 failed 时存在。
code
string错误码
message
string详细错误信息
output array
生成结果,成功时存在。
content
array生成的资源内容列表
type
string资源类型。
值:
audiourl
string生成资源 URL。文本类工具接口可能返回文本字段而不是 URL。
jobId
string上游任务 ID。
usage object
使用统计,成功时存在。
cost
string总费用(美元)。
discount
number折扣金额。
metadata object
元数据信息。