跳转到主要内容
POST
/
v1
/
music_cover_preprocess
翻唱前处理 (Music Cover Preprocess)
curl --request POST \
  --url https://api.minimaxi.com/v1/music_cover_preprocess \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "model": "music-cover",
  "audio_url": "https://example.com/song.mp3"
}
'
{
  "cover_feature_id": "a1b2c3d4e5f67890abcdef1234567890",
  "formatted_lyrics": "[Verse 1]\n歌曲第一行\n歌曲第二行\n\n[Chorus]\n这是副歌部分\n高声歌唱",
  "structure_result": "{\"num_segments\":4,\"segments\":[{\"start\":0,\"end\":15.5,\"label\":\"intro\"},{\"start\":15.5,\"end\":45.2,\"label\":\"verse\"},{\"start\":45.2,\"end\":75.0,\"label\":\"chorus\"},{\"start\":75.0,\"end\":90.0,\"label\":\"outro\"}]}",
  "audio_duration": 90,
  "trace_id": "061e5f144eb7f10b1fdde81126e24f91",
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

授权

​
Authorization
string
header
必填

HTTP: Bearer Auth

  • Security Scheme Type: http
  • HTTP Authorization Scheme: Bearer API_key，用于验证账户信息，可在 账户管理>接口密钥 中查看。

请求头

​
Content-Type
enum<string>
默认值:application/json
必填

请求体的媒介类型，请设置为 application/json，确保请求数据的格式为 JSON

可用选项:
application/json

请求体

application/json
​
model
enum<string>
必填

模型名称。必须为 music-cover。

可用选项:
music-cover
​
audio_url
string

参考音频的 URL 地址。audio_url 和 audio_base64 必须且只能提供其中一个。

参考音频要求：

  • 时长：6 秒至 6 分钟
  • 大小：最大 50 MB
  • 格式：支持常见音频格式（mp3、wav、flac 等）
​
audio_base64
string

Base64 编码的参考音频。audio_url 和 audio_base64 必须且只能提供其中一个。

参考音频要求：

  • 时长：6 秒至 6 分钟
  • 大小：最大 50 MB
  • 格式：支持常见音频格式（mp3、wav、flac 等）

响应

200 - application/json
​
cover_feature_id
string

预处理后的音频特征唯一标识，有效期 24 小时。将此 ID 传入音乐生成接口的 cover_feature_id 参数以进行两步翻唱。

相同音频内容会返回相同的 cover_feature_id（基于 MD5 去重）。

​
formatted_lyrics
string

通过 ASR 从参考音频中提取并格式化的歌词，包含 [Verse]、[Chorus]、[Bridge] 等段落标签。你可以修改这些歌词后传入音乐生成接口。

​
structure_result
string

JSON 字符串，包含歌曲结构分析结果，含段落类型（intro、verse、chorus、bridge、outro、inst、silence）及其起止时间戳（秒）。

​
audio_duration
number<double>

参考音频的时长（秒）。

​
trace_id
string

请求追踪 ID。

​
base_resp
object

状态码及详情