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
      • 创建音乐
        POST
      • 查询任务状态
        POST
      • 查询单个任务
        GET
      • 生成歌曲(拼接歌曲)
        POST
      • 创建歌手风格(Persona)
        POST
      • 生成歌词
        POST
      • 提升音乐风格
        POST
      • Timing:歌词、音频时间线
        GET
      • 获取wav
        GET
      • 我的音乐列表
        GET
      • 生成 MIDI
        GET
      • 波形图数据
        GET
      • MP4 生成状态
        GET
      • 获取音乐风格
        GET
      • 人声/伴奏分离(clipId)
        POST
      • 人声/伴奏分离(URL)
        POST
      • 全轨12路分离(clipId)
        POST
      • 全轨12路分离(URL)
        POST
      • 生成 MP4 视频
        POST
      • 重新生成封面图
        POST
      • 调整播放速度
        POST
      • 修改标题/封面
        POST
      • Fade 淡入淡出
        POST
      • 资源转临时地址
        POST
    • Suno 上传
      • 上传版权歌曲
    • 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/fetch
轮询入口之一。请求体为 task_id / clip id 列表(ids)。
注意:task_id 用于轮询任务;clip_id 用于续写/补段等,二者勿混用(API-Doc-Standards §2.4)。
根据任务 ID 列表批量查询任务或作品状态。

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

批量获取任务#

请求参数#

{
  "contentType": "application/json",
  "properties": {
    "action": {
      "description": "可空",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "Optional"
        }
      }
    },
    "ids": {
      "description": " 数组",
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "ids",
    "action"
  ]
}

请求示例 · 示例 1#

"{\n  \"ids\": [\"1264606079846457344\"],                        // taskBatchId 数组\n  \"action\": \"\"                                           // 可空\n}"

请求参数

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

示例
{
    "ids": [
        "task_abc123"
    ]
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location '/suno/fetch' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "ids": [
        "task_abc123"
    ]
}'

返回响应

🟢200成功
application/json
成功
Bodyapplication/json

示例
{
    "code": "string",
    "message": "string",
    "data": [
        {
            "task_id": "string",
            "action": "string",
            "status": "string",
            "fail_reason": "string",
            "data": {}
        }
    ]
}
🟠400请求有误
🟠401没有权限
修改于 2026-10-24 18:33:20
上一页
创建音乐
下一页
查询单个任务
Built with