接口提示
kirin_video_to_audio 是 Vtrix 包装模型. 上游音频工具不需要 model 字段; 调用 Vtrix 时仅将 kirin_video_to_audio 作为 model 值传入.
需要提供且仅提供一个主视频输入: video_url 或 video_id. 两者不能同时为空, 也不能同时有值.
认证
authorization string required
所有 API 均使用 Bearer Token 鉴权
获取 API Key：
访问 API Key 管理页面 获取 API Key
用法：
将以下 Header 添加到请求中：
Authorization: Bearer YOUR_API_KEY参数
model string required
请求使用的模型 ID
值: kirin_video_to_audio
video_url string
用于音频生成的公开视频 URL. video_url 与 video_id 互斥, 必须提供其中一个且只能提供一个.
支持格式: mp4, mov
最大文件大小: 100 MB
视频时长: 3.0 - 20.0 秒
video_id string
用于音频生成的已有视频任务 ID. video_id 与 video_url 互斥, 必须提供其中一个且只能提供一个.
仅支持可灵 AI 近 30 天内生成且时长为 3.0 - 20.0 秒的视频
sound_effect_prompt string
描述期望音效的提示词, 选填
长度不能超过 200 个字符
bgm_prompt string
描述期望背景音乐的提示词, 选填
长度不能超过 200 个字符
asmr_mode boolean
是否开启 ASMR 模式. 该模式会增强细节音效, 适合高沉浸内容场景.
true: 开启 ASMR 模式
false: 关闭 ASMR 模式
默认值: false
callback_url string
任务状态变更时的回调通知地址. 配置后服务端会主动通知任务结果
external_task_id string
自定义任务 ID, 传入不会覆盖系统生成的任务 ID, 但支持通过该 ID 进行任务查询
注：单用户下需要保证唯一性
轮询
由于结果生成需要时间，您需要在创建任务后轮询任务状态
初始响应只返回任务 ID 和初始状态等信息，最终生成结果需通过使用该任务 ID 轮询任务状态接口获取
轮询请求与响应示例见右侧