上传音频并翻唱

  • 上传一段音频，用新风格重新演绎，一步完成，异步任务
  • 与「风格翻唱」不同：这里直接收 audio_url，不用 task_id
  • 适合用户上传自己哼唱的场景
POST/v1/music/generations/uploadCover

认证

string必填

所有接口均使用 Bearer Token 进行认证。

获取 API Key：访问控制台 创建。

请求时在请求头中添加：

Authorization: Bearer YOUR_OAIRoute_KEY

请求参数

string可选

固定为 suno，默认值也是 suno。

string必填

公网可直链访问的 HTTP(S) 音频地址。

本地路径、blob: 地址、以及需要登录才能打开的页面链接都不支持。建议音频长度不超过 8 分钟。

string可选

可选 v6（默认）、v6-wild、v6-mini。使用 custom_model_id 时不要填写。

string可选

创建模型任务时返回的完整 UUID。与 version、persona_id 不能同时使用。

boolean可选

建议明确传入。

为 false 时使用 gpt_description；为 true 时使用歌词和风格字段。

boolean可选

是否生成纯音乐，默认 false。

当 custom=true 且本字段为 false 时，必须填写 prompt。

string条件必填

灵感描述。custom=false 时必填，上限 3000 字符。

string条件必填

自定义模式歌词，上限 5000 字符。

string可选

风格描述，上限 1000 字符。

string可选

标题，上限 80 字符。

string可选

不希望出现的风格。

number可选

风格权重，0 到 1。

number可选

创意度权重，0 到 1。

number可选

音频权重，0 到 1。

boolean可选

是否对输入的歌词再做一次改编。

string可选

Male 或 Female。

string可选

Persona ID。与 custom_model_id 不能同时使用。

integer可选

目标时长，10 到 360 秒。只在自定义模式下有效。

string可选

风格变化程度：off、normal、high、extra 或 max。

boolean可选

Max 模式，默认 false。要求使用自定义模式，费用按普通售价的 2 倍计算。

string可选

输出格式：mp3、m4a 或 wav。

与其他上传接口的分工

接口输入产出
上传音频audioFilePath只有 task_id，供后续引用
上传并翻唱（本页）audio_url直接出翻唱成品
上传并延伸audio_url直接出延伸成品

本接口是「上传 + 翻唱」一步到位，省掉先传后引用的两步操作。

custom 建议明确传。不传时后端会按内容推断，推断结果可能与你预期不同——尤其是同时传了 prompt 和 gpt_description 的时候。

响应

integer

状态码。

data[0] 的元素字段 · 2 项
string

提交状态，例如 submitted。

string

任务 ID，用于轮询查询结果。

成功时返回 code: 200。读取 data[0].task_id 后轮询 GET /v1/music/tasks/{task_id} 即可。

音频准备

audio_url 的要求比一般素材更严：

  • 必须公网直接可下载，不能要登录态
  • 不能是 blob: 或本地路径
  • 建议不超过 8 分钟

8 分钟以上会被拒或处理质量下降。长音频先自己切出最有代表性的片段。

错误码

错误响应的格式、状态码与重试建议见错误码与限流，常见报错的排查步骤见常见问题。

使用示例

用上传音频做翻唱

给一段公网可下载的音频，模型按提示词重新编曲演唱。audio_url 只接受 HTTP(S)，本地路径和 blob: 都不行。

灵感模式重写

custom 保持默认 false 时，prompt 按创意描述理解。想要精确控制歌词时把 custom 设为 true，改用 prompt 传歌词本体。

自定义模式并具名

custom 设为 true 后，title、tags、negative_tags 才会生效。灵感模式下这几个字段会被直接丢弃。

生成纯音乐

instrumental 设为 true 输出无人声版本，适合做背景乐或伴奏。