apimaxDocs
文档定价控制台
API 参考接入指南用户指南更新日志

音乐系列

POST上传音频

图像系列

视频系列

任务管理

错误码参考查询任务状态GET

账户管理

查询额度使用情况GET

文档 / 音乐系列 / Suno / 上传音频

上传音频POSTSunouploadclipsuno_upload_audio

上传音频

把用户音频导入为 Suno 自有 clip，返回异步上传任务 ID；带 copyright=true 时改走版权音乐管线。

POSThttps://api.apimax.ai/v1/music/upload/audio
试一试
Bearer API KeyJSON服务端调用

用途#

把用户音频导入为 Suno 自有 clip。该接口为异步透传：校验通过后立即返回 task_id，后台 worker 完成 Suno 原生上传流程，任务 SUCCESS 后结果中包含 clip_id，可用于续接、cover 等场景。

请求中带 copyright=true 时改走版权音乐管线：音频会被变速、切段后重新渲染为一段时长与原曲一致的成品音频（详见下文「版权音乐分支」）。

传参方式#

支持四种方式：

方式Content-Type说明
multipartmultipart/form-data文件字段为 file 或 audio
二进制流audio/mpeg、audio/wav 等整个请求体为音频字节
Base64 JSONapplication/jsonaudio 为标准 base64，filename 可选
URL 代拉 JSONapplication/jsonaudio_url 为 http 或 https 音频地址

请求体透传上游，relay 侧不做业务解析。

可选字段#

除音频本身外还接受以下字段（multipart 方式放 form 字段，JSON 方式放 body 字段；title / mode 仅在 copyright=true 时生效）：

字段类型说明
copyrightbool是否按版权音乐处理。true 时改走版权管线，产物是重新渲染的成品音频而不是普通 clip；未传或 false 时走原生上传，行为不变
titlestring版权分支可选：成品与 Studio 项目的命名
modestring版权分支可选：变速切段策略，默认 auto，见下表；传非法值返回 400
mode策略
auto（默认）先 2 倍变速（音高不变）再切段，段数少、速度快；若全部片段被版权过滤拒绝，自动退回原速切段
whole严格模式：2 倍被拒后改试 4 倍变速切段，不退回原速；4 倍拉伸有音质损失
segments原速直接切段：段数多、耗时长，但总有可行长度

请求示例#

multipart#

text
file: @song.mp3

也可以使用 audio 字段：

text
audio: @song.wav

二进制流#

text
<song.mp3 的二进制内容>

Base64 JSON#

json
{
  "audio": "SUQzBAAAAA...",
  "filename": "song.mp3"
}

URL 代拉 JSON#

json
{
  "audio_url": "https://example.com/song.mp3"
}

版权音乐分支#

multipart 方式附加 form 字段：

bash
curl -X POST https://api.apimax.ai/v1/music/upload/audio \
  -H "Authorization: Bearer <你的 API Key>" \
  -F "file=@song.mp3" \
  -F "copyright=true" \
  -F "title=我的版权音频"

JSON 方式（base64 / URL 代拉）放 body 字段：

json
{
  "audio_url": "https://example.com/song.mp3",
  "copyright": true,
  "title": "我的版权音频",
  "mode": "auto"
}

成功响应#

200
{
  "code": "success",
  "message": "",
  "data": "task_upload_01JABCDEF0123456789"
}

普通上传返回形如 task_upload_* 的任务 ID；版权分支返回形如 task_recut_* 的任务 ID。

响应字段#

字段类型说明
codestring响应码，成功固定为 success
messagestring提示信息，成功时通常为空
datastring公开任务 ID，用于后续 fetch 查询

查询结果#

提交成功后，用返回的 task_id 轮询：

  • 单个查询：GET /v1/tasks/:id

任务 SUCCESS 后，结果中包含导入后的 clip_id。

查询结果示例（普通上传）#

查询接口返回统一任务对象。任务 status 为 completed 时，导入的 clip 位于 data 数组，data[0].id 即后续续写、cover 等生成动作使用的 clip_id：

json
{
  "created_at": 1785295769,
  "data": [
    {
      "audio_url": "https://cdn1.suno.ai/7e34e133-505b-47eb-87d7-e274dea678ba.mp3",
      "created_at": "2026-05-12T08:00:00.000Z",
      "duration": 12,
      "id": "7e34e133-505b-47eb-87d7-e274dea678ba",
      "status": "complete",
      "title": "song.mp3"
    }
  ],
  "finished_at": 1785295792,
  "id": "task_71MViZBEC1FfBPAaK6Prlj2agBoZeJGE",
  "model": "suno_upload_audio",
  "object": "task",
  "platform": "suno",
  "progress": 100,
  "started_at": 1785295770,
  "status": "completed",
  "type": "suno"
}

版权音乐分支（copyright=true）#

带 copyright=true 时，上传的音频不再产出普通 clip，而是由版权管线处理：

  • 变速 + 切段：先把整首歌保持音高加速（默认 2 倍），再对变速后的音频按低能量点切段上传，短片段 + 变速双重绕过版权指纹；被版权过滤拒绝的片段会自动切得更小重试，不会因此直接失败。
  • 拼轨回原时长：各片段渲染后线性拉伸拼回原曲时间轴，成品时长与原曲一致。
  • 产物：一段成品音频（m4a）及对应的 Suno clip_id，data[0] 结构见下方示例。

约束#

  • 大小上限 100MB（普通上传为 500MB），超限返回 413。
  • 时长窗口 6 秒 ~ 8 分钟，越界返回 400。
  • 平台需至少有一个可用账号，否则返回 503。
  • 耗时随 mode 差别较大：auto 约 2 分钟；segments 段数多，可达 20 分钟量级。

查询结果示例（版权分支）#

任务 status 为 completed 后，成品位于 data[0]：

json
{
  "created_at": 1785309517,
  "data": [
    {
      "audio_url": "https://<平台存储>/media/cdn/12d766df-257c-4874-9293-1d72a80072c4.m4a?<预签名参数>",
      "clip_count": 6,
      "duration": 206.59,
      "final_clip_id": "12d766df-257c-4874-9293-1d72a80072c4",
      "id": "12d766df-257c-4874-9293-1d72a80072c4",
      "project_id": "b611dc6e-9eeb-4665-b706-cd1e2609d794",
      "project_url": "https://suno.com/studio/b611dc6e-9eeb-4665-b706-cd1e2609d794",
      "song_url": "https://suno.com/song/12d766df-257c-4874-9293-1d72a80072c4",
      "status": "complete",
      "title": "我的版权音频"
    }
  ],
  "finished_at": 1785309619,
  "id": "task_EIGnOu1GpdX2moifZl3BbajqhNnadqGp",
  "model": "suno_upload_audio",
  "object": "task",
  "platform": "suno",
  "progress": 100,
  "started_at": 1785309518,
  "status": "completed",
  "type": "suno"
}
字段说明
id / final_clip_id渲染成品的 Suno clip id
audio_url成品音频下载地址（m4a，由平台自有存储供数，预签名链接约 7 天有效，建议尽快转存）
song_urlSuno 站内歌曲页
project_url / project_idStudio 项目页 / 项目 id
clip_count切段上传的片段数
duration提交时嗅探的源音频时长（秒）
版权上传统一从本接口加 copyright=true 进入；旧的独立端点 /v1/music/upload/copyright-audio 已下线。

计费#

按次计费，以平台「模型价格」页为准：

  • 普通上传（copyright 未传或 false）：按 suno_upload_audio 单价计费
  • 版权分支（copyright=true）：按 10 倍 单价计费（与原独立版权端点同价），提交时预扣，用量日志中显示 copyright ×10 倍率

下一步

全部文档
润色风格标签把风格标签和歌词润色扩写成更完整的风格描述。获取风格灵感建议获取 Suno 上游的随机风格或灵感建议。方法一:从已有歌曲创建音色使用本池已生成的歌曲 clip 直接创建人声音色。获取 MIDI为本服务已生成的 clip 获取 MIDI 文件。获取歌词时间轴获取已生成 clip 的歌词对齐时间轴。[核心]音乐生成通过统一音乐生成接口提交异步任务，并使用公开任务 ID 查询规范化音乐结果。
本页导航
概览用途传参方式可选字段请求示例multipart二进制流Base64 JSONURL 代拉 JSON版权音乐分支成功响应响应字段查询结果查询结果示例（普通上传）版权音乐分支（copyright=true）约束查询结果示例（版权分支）计费下一步
API

POST /v1/music/upload/audio