一、接口概述
本接口用于实现 AI 歌曲翻唱功能，支持通过传入音乐音频 URL、人声音频 URL 及回调 URL，获取翻唱任务 ID，后续可通过回调 URL 接收翻唱结果。
二、核心信息
（一）接口地址
https://#/api/aibasic/songcover
（二）返回格式
application/json
（三）请求方式
支持 HTTP GET / POST 两种请求方式
三、请求配置
（一）请求头（HEADER）
名称
值
Content-Type
application/x-www-form-urlencoded;charset=utf-8
（二）请求参数
名称
必填
类型
示例值
说明
key
是
string
35kj5jnlj53453kl5j43nj5
接口密钥，需在控制台 -> 密钥管理页面查看获取
source_audio_url
是
string
https://#/#.mp3
待翻唱的音乐音频 URL（需为 MP3 格式，确保 URL 可正常访问）
reference_audio_url
是
string
https://#/#.mp3
人声音频 URL，建议录制 10-15 秒所需翻唱歌曲的高潮部分，可优化翻唱效果
callback_url
是
string
https://#/callback
回调 URL，用于接收翻唱任务的执行结果（需确保 URL 可正常接收回调请求）
（三）请求示例
https://#/api/aibasic/songcover?key=35kj5jnlj53453kl5j43nj5&source_audio_url=https://#/#.mp3&reference_audio_url=https://#/#.mp3&callback_url=https://#/callback
（POST 请求时，参数需按 application/x-www-form-urlencoded 格式拼接在请求体中）
四、返回数据说明
（一）返回参数
名称
类型
说明
code
int
状态码（200 表示请求成功，其他为异常）
msg
string
状态信息（成功时返回 "success"）
data
string
请求结果数据集（成功时包含任务 ID）
debug
string/array
调试数据（异常时返回，用于问题排查）
exec_time
float
接口执行耗时（单位：秒）
user_ip
string
客户端 IP 地址
（二）返回示例（成功）
{
"code": 200,
"msg": "success",
"data": {
"task_id": "task123456789"
},
"exec_time": 2.164673,
"user_ip": "117.188.14.246"
}
（三）状态码说明
200：请求成功，已创建翻唱任务，可通过 task_id 关联后续回调结果
其他状态码：请求异常，可通过 msg 和 debug 字段排查问题（如密钥错误、URL 不可访问、参数缺失等）
五、开发注意事项
音频 URL 限制：source_audio_url 和 reference_audio_url 需为 MP3 格式，且 URL 需支持公网访问（避免私有链接或有效期过短的链接）。
人声音频要求：建议严格按照 10-15 秒高潮部分录制，确保人声清晰、无明显杂音，以提升翻唱效果。
回调 URL 配置：需确保回调地址可正常接收 POST 请求，且能处理接口返回的任务结果数据。
密钥安全：key 为接口访问凭证，请勿泄露给第三方，若泄露需及时在控制台重置。
错误处理：若返回非 200 状态码，可先检查参数格式、URL 有效性、密钥正确性，再通过 debug 字段定位具体问题。
来源：酷虎云api开放平台
