API reference
🇺🇸 English
  • 🇨🇳 Chinese
  • 🇺🇸 English
  1. Suno
API reference
🇺🇸 English
  • 🇨🇳 Chinese
  • 🇺🇸 English
  • Chat Models
    • Chat
      • Create chat completion
      • vision
    • OpenAI-Realtime
    • Completions
      • Instruct
    • Audio
      • Transcriptions
      • Translations
      • Speech
    • Image generation
      • DALL·E 3
    • Embeddings
      • Create
    • Models
      • model list
    • Help
      • 常见问题及解决办法
  • Anthropic
    • Anthropic Claude
  • Suno
    • Generate music
      POST
    • Generate lyrics
      POST
    • Upload music
      POST
    • Music concat
      POST
    • Fetch task
      GET
    • Fetch batch tasks
      POST
  • Udio
    • Generate music
    • Fetch task
  • Midjourney API
    • Quick
    • Task Submit
      • Imagine
      • Action
      • Modal
      • Blend
      • Describe
      • Shorten
      • Upload discord
    • Get Task
      • Fetch task by ids
      • Fetch task by id
      • Get seed
  • Flux
    • Official
      • Generate
      • Finetune
      • Fetch task
    • OpenAI Dalle3
  • Recraft
    • Official
      • Generate Image
      • Vectorize Image
      • Remove Background
      • Clarity Upscale
      • Generative Upscale
      • Create style
    • OpenAI Dalle3
  • Ideogram
    • Generate
    • Remix
    • Edit
    • Upscale
    • Describe
  • Luma
    • Official
      • Generate
      • Fetch task
    • Own format
      • Submit
        • Generate
        • Get video of no mark
        • 扩展视频
      • Get task
        • Get task
        • Get batch task
  • Runway
    • Official
      • image to video
      • get task
    • reverse
      • text to video
      • image to video
      • video2video
      • Act-one
      • Get task
  • Kling-API
    • Callback
    • Generate image
    • Text 2 Video
    • Image 2 Video
    • Video extend
    • Get task
    • lip-sync
    • kolors-virtual-try-on
  • Replicate
    • Generate
    • Get
  • MiniMax
    • Generate video
    • Get task
    • Get file
  1. Suno

Fetch batch tasks

POST
/suno/fetch
最后修改时间:2025-05-06 01:23:05

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Header 参数
Authorization
string 
可选
默认值:
{{YOUR_API_KEY}}
Body 参数application/json
ids
array[string]
必需
task_id 列表
action
string 
必需
操作:MUSIC、LYRICS
示例
{
    "ids": [
        "string"
    ],
    "action": "string"
}

示例代码

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

返回响应

🟢200成功
application/json
Body
code
string 
必需
message
string 
必需
data
array [object {10}] 
必需
task_id
string 
可选
notify_hook
string 
可选
action
string 
可选
status
string 
可选
fail_reason
string 
可选
submit_time
integer 
可选
start_time
integer 
可选
finish_time
integer 
可选
progress
string 
可选
data
array [object {10}] 
可选
示例
{
    "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"
                }
            ]
        }
    ]
}
上一页
Fetch task
下一页
Generate music
Built with