Skip to main content
POST
翻唱前处理 (Music Cover Preprocess)

授权

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_urlaudio_base64 必须且只能提供其中一个。

参考音频要求:

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

Base64 编码的参考音频。audio_urlaudio_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 字符串,包含歌曲结构分析结果,含段落类型(introversechorusbridgeoutroinstsilence)及其起止时间戳(秒)。

audio_duration
number<double>

参考音频的时长(秒)。

trace_id
string

请求追踪 ID。

base_resp
object

状态码及详情