一、接口概述
本接口用于實現(xiàn) AI 歌曲翻唱功能，支持通過傳入音樂音頻 URL、人聲音頻 URL 及回調 URL，獲取翻唱任務 ID，后續(xù)可通過回調 URL 接收翻唱結果。
二、核心信息
（一）接口地址
https://#/api/aibasic/songcover
（二）返回格式
application/json
（三）請求方式
支持 HTTP GET / POST 兩種請求方式
三、請求配置
（一）請求頭（HEADER）
名稱
值
Content-Type
application/x-www-form-urlencoded;charset=utf-8
（二）請求參數(shù)
名稱
必填
類型
示例值
說明
key
是
string
35kj5jnlj53453kl5j43nj5
接口密鑰，需在控制臺 -> 密鑰管理頁面查看獲取
source_audio_url
是
string
https://#/#.mp3
待翻唱的音樂音頻 URL（需為 MP3 格式，確保 URL 可正常訪問）
reference_audio_url
是
string
https://#/#.mp3
人聲音頻 URL，建議錄制 10-15 秒所需翻唱歌曲的高潮部分，可優(yōu)化翻唱效果
callback_url
是
string
https://#/callback
回調 URL，用于接收翻唱任務的執(zhí)行結果（需確保 URL 可正常接收回調請求）
（三）請求示例
https://#/api/aibasic/songcover?key=35kj5jnlj53453kl5j43nj5&source_audio_url=https://#/#.mp3&reference_audio_url=https://#/#.mp3&callback_url=https://#/callback
（POST 請求時，參數(shù)需按 application/x-www-form-urlencoded 格式拼接在請求體中）
四、返回數(shù)據(jù)說明
（一）返回參數(shù)
名稱
類型
說明
code
int
狀態(tài)碼（200 表示請求成功，其他為異常）
msg
string
狀態(tài)信息（成功時返回 "success"）
data
string
請求結果數(shù)據(jù)集（成功時包含任務 ID）
debug
string/array
調試數(shù)據(jù)（異常時返回，用于問題排查）
exec_time
float
接口執(zhí)行耗時（單位：秒）
user_ip
string
客戶端 IP 地址
（二）返回示例（成功）
{
? "code": 200,
? "msg": "success",
? "data": {
? ? "task_id": "task123456789"
? },
? "exec_time": 2.164673,
? "user_ip": "117.188.14.246"
}
（三）狀態(tài)碼說明
200：請求成功，已創(chuàng)建翻唱任務，可通過 task_id 關聯(lián)后續(xù)回調結果
其他狀態(tài)碼：請求異常，可通過 msg 和 debug 字段排查問題（如密鑰錯誤、URL 不可訪問、參數(shù)缺失等）
五、開發(fā)注意事項
音頻 URL 限制：source_audio_url 和 reference_audio_url 需為 MP3 格式，且 URL 需支持公網(wǎng)訪問（避免私有鏈接或有效期過短的鏈接）。
人聲音頻要求：建議嚴格按照 10-15 秒高潮部分錄制，確保人聲清晰、無明顯雜音，以提升翻唱效果。
回調 URL 配置：需確?；卣{地址可正常接收 POST 請求，且能處理接口返回的任務結果數(shù)據(jù)。
密鑰安全：key 為接口訪問憑證，請勿泄露給第三方，若泄露需及時在控制臺重置。
錯誤處理：若返回非 200 狀態(tài)碼，可先檢查參數(shù)格式、URL 有效性、密鑰正確性，再通過 debug 字段定位具體問題。
來源：酷虎云api開放平臺
