接口提示
kirin_text_to_audio 是 Vtrix 包装模型. 上游音频工具不需要 model 字段; 调用 Vtrix 时仅将 kirin_text_to_audio 作为 model 值传入.
认证
authorization string required
所有 API 均使用 Bearer Token 鉴权
获取 API Key：
访问 API Key 管理页面 获取 API Key
用法：
将以下 Header 添加到请求中：
Authorization: Bearer YOUR_API_KEY参数
model string required
请求使用的模型 ID
值: kirin_text_to_audio
prompt string required
描述期望音效或短音频片段的文本提示词
长度不能超过 200 个字符
duration float required
期望音频时长, 单位为秒
范围: 3.0 - 10.0
精度: 支持 1 位小数
callback_url string
任务状态变更时的回调通知地址. 配置后服务端会主动通知任务结果
external_task_id string
自定义任务 ID, 传入不会覆盖系统生成的任务 ID, 但支持通过该 ID 进行任务查询
注：单用户下需要保证唯一性
轮询
由于结果生成需要时间，您需要在创建任务后轮询任务状态
初始响应只返回任务 ID 和初始状态等信息，最终生成结果需通过使用该任务 ID 轮询任务状态接口获取
轮询请求与响应示例见右侧