1. Suno 上传
梧柏API使用文档
WHBAI · Suno
  • WHBAI · Google Gemini 原生 (v1alpha)
  • WHBAI · Google Gemini 原生
  • WHBAI · Ideogram
  • WHBAI · Ideogram V3
  • WHBAI · Midjourney
  • WHBAI · Jimeng
  • WHBAI · Kling
  • WHBAI · Luma
  • WHBAI · Luma V1
  • WHBAI · Omni 视频
  • WHBAI · Pixverse
  • WHBAI · Runway
  • WHBAI · Sora2
  • WHBAI · 统一视频 VEO
  • WHBAI · Vidu
  • WHBAI · 豆包 Volc
  • WHBAI · Suno
  • WHBAI · Playground
  • WHBAI · 账号与令牌
  • WHBAI · 阿里 Pix
  • WHBAI · 阿里百炼
  • WHBAI · 私域人像
  • WHBAI · Fal.ai
  • WHBAI · Replicate
  • WHBAI · 腾讯云 VOD
  • WHBAI · MiniMax
  • WHBAI · 支持模型列表
  • WHBAI · Grok Imagine
  • WHBAI · Seedance 2.0
  • WHBAI · TypeSafe
  • WHBAI · OpenAI 兼容
  • 文生音乐
    • Suno
      • 创建音乐
      • 查询任务状态
      • 查询单个任务
      • 生成歌曲(拼接歌曲)
      • 创建歌手风格(Persona)
      • 生成歌词
      • 提升音乐风格
      • Timing:歌词、音频时间线
      • 获取wav
      • 我的音乐列表
      • 生成 MIDI
      • 波形图数据
      • MP4 生成状态
      • 获取音乐风格
      • 人声/伴奏分离(clipId)
      • 人声/伴奏分离(URL)
      • 全轨12路分离(clipId)
      • 全轨12路分离(URL)
      • 生成 MP4 视频
      • 重新生成封面图
      • 调整播放速度
      • 修改标题/封面
      • Fade 淡入淡出
      • 资源转临时地址
    • Suno 上传
      • 上传版权歌曲
        POST
    • Suno 账户
      • 账户积分余额
  • 数据模型
    • SunoSubmitMusicRequest
    • SunoSubmitMusicResponse
    • SunoFetchRequest
    • SunoTaskData
    • SunoTaskResponse
    • SunoFetchResponse
    • metadataParams
    • PostSunoSubmitPersonaRequest
    • PostSunoUploadsAudioRequest
    • PostSunoSubmitStemsRequest
    • PostSunoSubmitStemsResponse
    • PostSunoSubmitStemsByUrlResponse
    • PostSunoSubmitStemsAllResponse
    • PostSunoSubmitStemsAllByUrlResponse
    • PostSunoSubmitMp4Response
    • PostSunoSubmitRegenImgResponse
    • PostSunoSubmitAdjustSpeedRequest
    • PostSunoSubmitSetMetadataRequest
    • PostSunoSubmitFadeRequest
    • NewApiError
  1. Suno 上传

上传版权歌曲

POST
/suno/uploads/audio
上传版权音频到 Suno,用于后续续写或 Persona 等操作。

网站中的模型与调用示例#

上传参考音频#

请求参数#

{
  "contentType": "application/json",
  "properties": {
    "name": {
      "description": "显示名,可空",
      "type": "string"
    },
    "timeout": {
      "description": "超时秒数,默认 90",
      "type": "integer"
    },
    "url": {
      "description": "公网可访问 mp3,必填",
      "type": "string"
    }
  },
  "required": [
    "url",
    "name",
    "timeout"
  ]
}

请求示例 · 上传参考音频#

"{\n  \"url\": \"https://cdn1.suno.ai/363675c6-cf6d-4904-8702-00d272edb42d.mp3\",                 // 公网可访问 mp3,必填\n  \"name\": \"参考音频\",                                     // 显示名,可空\n  \"timeout\": 90                                          // 超时秒数,默认 90\n}"

请求示例 · 上传版权歌曲#

"{\n  \"url\": \"https://cdn1.suno.ai/ad94e107-37a2-4ee1-acbe-9138a47b07b7.mp3?v=1.6\",\n  \"name\": \"江海\",\n  \"uploadType\": \"MUSIC_COPYRIGHT\", //默认NORMAL;NORMAL:普通上传方式;MUSIC_COPYRIGHT:版权音乐上传方式\n  \"speedMultiplier\": 1.0,\n  \"speedMultiplierFix\": true\n}"

上传参考音频#

请求参数#

{
  "contentType": "application/json",
  "properties": {
    "name": {
      "description": "显示名,可空",
      "type": "string"
    },
    "timeout": {
      "description": "超时秒数,默认 90",
      "type": "integer"
    },
    "url": {
      "description": "公网可访问 mp3,必填",
      "type": "string"
    }
  },
  "required": [
    "url",
    "name",
    "timeout"
  ]
}

请求示例 · 上传参考音频#

"{\n  \"url\": \"https://cdn1.suno.ai/363675c6-cf6d-4904-8702-00d272edb42d.mp3\",                 // 公网可访问 mp3,必填\n  \"name\": \"参考音频\",                                     // 显示名,可空\n  \"timeout\": 90                                          // 超时秒数,默认 90\n}"

请求示例 · 上传版权歌曲#

"{\n  \"url\": \"https://cdn1.suno.ai/ad94e107-37a2-4ee1-acbe-9138a47b07b7.mp3?v=1.6\",\n  \"name\": \"江海\",\n  \"uploadType\": \"MUSIC_COPYRIGHT\", //默认NORMAL;NORMAL:普通上传方式;MUSIC_COPYRIGHT:版权音乐上传方式\n  \"speedMultiplier\": 1.0,\n  \"speedMultiplierFix\": true\n}"

上传参考音频#

请求参数#

{
  "contentType": "application/json",
  "properties": {
    "name": {
      "description": "显示名,可空",
      "type": "string"
    },
    "timeout": {
      "description": "超时秒数,默认 90",
      "type": "integer"
    },
    "url": {
      "description": "公网可访问 mp3,必填",
      "type": "string"
    }
  },
  "required": [
    "url",
    "name",
    "timeout"
  ]
}

请求示例 · 上传参考音频#

"{\n  \"url\": \"https://cdn1.suno.ai/363675c6-cf6d-4904-8702-00d272edb42d.mp3\",                 // 公网可访问 mp3,必填\n  \"name\": \"参考音频\",                                     // 显示名,可空\n  \"timeout\": 90                                          // 超时秒数,默认 90\n}"

请求示例 · 上传版权歌曲#

"{\n  \"url\": \"https://cdn1.suno.ai/ad94e107-37a2-4ee1-acbe-9138a47b07b7.mp3?v=1.6\",\n  \"name\": \"江海\",\n  \"uploadType\": \"MUSIC_COPYRIGHT\", //默认NORMAL;NORMAL:普通上传方式;MUSIC_COPYRIGHT:版权音乐上传方式\n  \"speedMultiplier\": 1.0,\n  \"speedMultiplierFix\": true\n}"

请求参数

Authorization
Bearer Token
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
or
Body 参数application/json必填

示例
{
    "url": "https://cdn1.suno.ai/ad94e107-37a2-4ee1-acbe-9138a47b07b7.mp3?v=1.6",
    "name": "江海",
    "upload_type": "MUSIC_COPYRIGHT",
    "speed_multiplier": 1,
    "speed_multiplier_fix": true
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location '/suno/uploads/audio' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "url": "https://cdn1.suno.ai/ad94e107-37a2-4ee1-acbe-9138a47b07b7.mp3?v=1.6",
    "name": "江海",
    "upload_type": "MUSIC_COPYRIGHT",
    "speed_multiplier": 1,
    "speed_multiplier_fix": true
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "code": "success",
    "data": {}
}
🟠400请求有误
🟠401没有权限
修改于 2026-10-24 18:33:20
上一页
资源转临时地址
下一页
账户积分余额
Built with