API reference
🇨🇳 Chinese
  • 🇨🇳 Chinese
  • 🇺🇸 English
  1. Suno(音乐)
API reference
🇨🇳 Chinese
  • 🇨🇳 Chinese
  • 🇺🇸 English
  • 系统内部接口
    • 用户查询账号信息
      GET
  • OpenAI
    • 聊天
      • 文本聊天
      • 识图
    • Responses
      • 创建模型响应
    • OpenAI-Realtime
      • Realtime
    • Completions
      • Instruct
    • 音频接口(Audio)
      • 音频转文本
      • 创建翻译
      • 文本转音频
    • 图像
      • 创建图像
      • 创建图像编辑
      • 创建图像变化
    • 嵌入
      • 创建嵌入
    • 审核
      • 创建审核
    • 模型
      • 获取模型列表
    • 帮助中心
      • 常见问题及解决办法
  • Anthropic
    • Anthropic Claude
  • Suno(音乐)
    • 场景一:续写音乐并获取完整音乐
    • 场景二:Cover 音乐:音乐翻版\修改风格
    • 场景三:Replace Section:替换片段
    • 场景四:Persona:歌手风格
    • 场景五:stems:声曲分离(仅限chirp_auk)
    • 场景六:Timing:歌词、音频时间线(仅限chirp_auk)
    • 场景七:wav:获取 wav 格式文件
    • 场景八:mp4:生成 mp4 mv 视频(仅限chirp_auk)
    • 生成音乐
      POST
    • 上传音乐
      POST
    • 歌曲拼接
      POST
    • 新建 Persona
      POST
    • 声曲分离
      GET
    • Timing:歌词、音频时间线
      GET
    • 获取 wav 格式文件
      GET
    • 生成 mp4 mv 视频
      GET
    • 生成歌词
      POST
    • 查询单个任务
      GET
    • 批量查询任务
      POST
    • 批量查询歌曲
      GET
  • Udio(音乐)
    • 官方格式
      • 生成音乐
      • 查询单个任务
  • Midjourney API文档(生图)
    • 快速教学-完整流程一遍过
    • 怎么切换不同的速度
    • 任务提交
      • 提交Imagine任务
      • 提交Action任务
      • 提交Blend任务
      • 提交Describe任务
      • 提交Modal
      • 提交Shorten任务
      • 提交swap_face任务
      • 上传文件到discord
    • 任务查询
      • 指定ID获取任务
      • 根据ID列表查询任务
      • 根据ID列表查询任务-字段displays
      • 获取任务图片的seed
      • 查询所有任务
      • 分页查询任务
      • 查询任务队列
      • 取消任务
  • Flux(生图)
    • 官方格式
      • 生成图片
      • 微调
      • 查询任务
    • OpenAI Dalle3格式
  • Recraft(生图)
    • 官方格式
      • 附录
      • Generate Image(生成图片)
      • Vectorize Image(矢量化图片)
      • Remove Background(删除背景)
      • Clarity Upscale(清晰度提升)
      • Generative Upscale(生成高清)
      • Create style(创建样式)
    • OpenAI Dalle3格式-生成图片
  • Ideogram(生图)
    • 官方文档(实时更新)
    • Generate with Ideogram 3.0
    • Edit with Ideogram 3.0
    • Remix with Ideogram 3.0
    • Reframe with Ideogram 3.0
    • Replace Background with Ideogram 3.0
    • Upscale
    • Describe
    • Generate(legacy)
    • Edit(legacy)
    • Remix(legacy)
  • Luma(视频)
    • 官方API格式接口
      • 生成视频
      • 单个查询任务
    • RixAPI格式接口
      • 任务提交
        • 文生视频
        • 图生视频
        • 扩展视频
        • 视频生成音频
        • 获取视频无水印链接
      • 任务查询
        • 单个查询任务
        • 批量查询任务
  • Runway(视频)
    • 官方API接口格式
      • 从图像生成视频
      • 获取任务详细信息
    • 逆向格式
      • generate(文本)
      • generate(参考图片)
      • video2video 视频转视频 风格重绘
      • Act-one 表情迁移
      • feed-获取任务
  • PIKA(视频)
    • generate(文本)
    • generate(参考图片)
    • generate(参考视频/扩展视频)
    • feed
  • 可灵API(官方接口)
    • 建议直接看官方文档
    • Callback协议
    • 生成图像
    • 文生视频
    • 图生视频
    • 多图参考生视频
    • 视频特效
    • 视频延长
    • 对口型
    • 虚拟试穿
    • 查询任务(单个)
  • Replicate 通用接口
    • 创建任务
    • 查询任务
  • MiniMax海螺(视频)
    • 官方文档
    • 视频生成
    • 查询任务
    • 文件下载
  1. Suno(音乐)

批量查询任务

POST
/suno/fetch
Last modified:2025-05-06 01:23:05

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Header Params
Authorization
string 
optional
Default:
{{YOUR_API_KEY}}
Body Params application/json
ids
array[string]
required
task_id 列表
action
string 
required
操作:MUSIC、LYRICS
Example
{
  "ids": [
    "string"
  ],
  "action": "string"
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request POST '/suno/fetch' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ids": [
        "string"
    ],
    "action": "string"
}'

Responses

🟢200成功
application/json
Body
code
string 
required
message
string 
required
data
array [object {10}] 
required
task_id
string 
optional
notify_hook
string 
optional
action
string 
optional
status
string 
optional
fail_reason
string 
optional
submit_time
integer 
optional
start_time
integer 
optional
finish_time
integer 
optional
progress
string 
optional
data
array [object {10}] 
optional
Example
{
  "code": "success",
  "message": "",
  "data": [
    {
      "task_id": "346c5d10-a4a1-4f49-a851-66a7dae6cfaf",
      "notify_hook": "",
      "action": "MUSIC",
      "status": "IN_PROGRESS",
      "fail_reason": "",
      "submit_time": 1716191749,
      "start_time": 1716191786,
      "finish_time": 0,
      "progress": "0%",
      "data": [
        {
          "id": "e9893d04-6a63-4007-8473-64b706eca4d1",
          "title": "Electric Dance Party",
          "status": "streaming",
          "metadata": {
            "tags": "club banger high-energy edm",
            "prompt": "[Verse]\nEverybody in the place\nLet's go\nJump and dance\nFeel the rhythm\nLose control (ooh-yeah!)\nHands up in the air\nIt's time to show\nMove your body like you're on a roll\n\nShake it to the left\nShake it to the right\nFeel the bass\nFeel the beat\nAll night (ooh-yeah!)\nMiku's in the house\nGonna set the stage on fire\nGet ready for a wild ride\nIt's our desire\n\n[Verse 2]\nLights are flashing\nColors everywhere (ooh-yeah!)\nFeel the energy\nIt's in the air\nWe're unstoppable\nNothing can bring us down\nDancing to the beat\nThe whole world around",
            "duration": null,
            "error_type": null,
            "error_message": null,
            "audio_prompt_id": null,
            "gpt_description_prompt": "miku dance"
          },
          "audio_url": "https://audiopipe.suno.ai/?item_id=e9893d04-6a63-4007-8473-64b706eca4d1",
          "image_url": "https://cdn1.suno.ai/image_e9893d04-6a63-4007-8473-64b706eca4d1.png",
          "video_url": "",
          "model_name": "chirp-v3",
          "image_large_url": "https://cdn1.suno.ai/image_large_e9893d04-6a63-4007-8473-64b706eca4d1.png",
          "major_model_version": "v3"
        },
        {
          "id": "fe69611b-fc72-4f6e-b476-5eef0b88c2e3",
          "title": "Electric Dance Party",
          "status": "streaming",
          "metadata": {
            "tags": "club banger high-energy edm",
            "prompt": "[Verse]\nEverybody in the place\nLet's go\nJump and dance\nFeel the rhythm\nLose control (ooh-yeah!)\nHands up in the air\nIt's time to show\nMove your body like you're on a roll\n\nShake it to the left\nShake it to the right\nFeel the bass\nFeel the beat\nAll night (ooh-yeah!)\nMiku's in the house\nGonna set the stage on fire\nGet ready for a wild ride\nIt's our desire\n\n[Verse 2]\nLights are flashing\nColors everywhere (ooh-yeah!)\nFeel the energy\nIt's in the air\nWe're unstoppable\nNothing can bring us down\nDancing to the beat\nThe whole world around",
            "duration": null,
            "error_type": null,
            "error_message": null,
            "audio_prompt_id": null,
            "gpt_description_prompt": "miku dance"
          },
          "audio_url": "https://audiopipe.suno.ai/?item_id=fe69611b-fc72-4f6e-b476-5eef0b88c2e3",
          "image_url": "https://cdn1.suno.ai/image_fe69611b-fc72-4f6e-b476-5eef0b88c2e3.png",
          "video_url": "",
          "model_name": "chirp-v3",
          "image_large_url": "https://cdn1.suno.ai/image_large_fe69611b-fc72-4f6e-b476-5eef0b88c2e3.png",
          "major_model_version": "v3"
        }
      ]
    }
  ]
}
Previous
查询单个任务
Next
批量查询歌曲
Built with