🇺🇸 English
🇺🇸 English
- Chat Models
- Chat
- OpenAI-Realtime
- Completions
- Audio
- Image generation
- Embeddings
- Models
- Help
- Anthropic
- Suno
- Udio
- Midjourney API
- Flux
- Recraft
- Ideogram
- Luma
- Runway
- Kling-API
- Replicate
- MiniMax
Fetch task
GET
/suno/fetch/{task_id}
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 ********************Path Params
task_id
string
required
Example:
ba46ad15-07ce-41a6-b68d-196321dc00d5
Header Params
Authorization
string
optional
Default:
{{YOUR_API_KEY}}
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 GET '/suno/fetch/ba46ad15-07ce-41a6-b68d-196321dc00d5' \
--header 'Authorization: 'Responses
🟢200成功
application/json
Body
code
string
required
message
string
required
data
object
required
task_id
string
required
notify_hook
string
required
action
string
required
status
string
required
fail_reason
string
required
submit_time
integer
required
start_time
integer
required
finish_time
integer
required
progress
string
required
data
object
required
Examples
{
"code": "success",
"message": "",
"data": {
"task_id": "ba46ad15-07ce-41a6-b68d-196321dc00d5",
"action": "MUSIC",
"status": "SUCCESS",
"fail_reason": "",
"submit_time": 1733717567,
"start_time": 1733717567,
"finish_time": 1733717767,
"progress": "100%",
"data": [
{
"id": "a06015d0-9e04-4f30-85db-401494940394",
"mv": "chirp-v4",
"msg": "",
"tags": "emotional punk",
"state": "succeeded",
"title": "City Lights",
"prompt": "[Verse]\nWalking down the streets\nBeneath the city lights\nNeon signs flickering\nLighting up the night\nHeart beating faster\nLike a drum in my chest\nI’m alive in this moment\nFeeling so blessed\n\nStilettos on the pavement\nStepping with grace\nSurrounded by the people\nMoving at their own pace\nThe rhythm of the city\nIt pulses in my veins\nLost in the energy\nAs my worries drain\n\n[Verse 2]\nConcrete jungle shining\nWith its dazzling glow\nEvery corner hiding secrets that only locals know\nA symphony of chaos\nBut it’s music to my ears\nThe hustle and the bustle\nWiping away my fears",
"status": "complete",
"clip_id": "a06015d0-9e04-4f30-85db-401494940394",
"task_id": "ba46ad15-07ce-41a6-b68d-196321dc00d5_1",
"duration": 219,
"audio_url": "https://cdn1.suno.ai/a06015d0-9e04-4f30-85db-401494940394.mp3",
"image_url": "https://cdn2.suno.ai/image_a06015d0-9e04-4f30-85db-401494940394.jpeg",
"video_url": "https://cdn1.suno.ai/a06015d0-9e04-4f30-85db-401494940394.mp4",
"continue_at": null,
"create_time": "1733717599",
"update_time": "1733717785",
"image_large_url": "https://cdn2.suno.ai/image_large_a06015d0-9e04-4f30-85db-401494940394.jpeg",
"continue_clip_id": null,
"gpt_description_prompt": null
},
{
"id": "a6bd6a70-4cde-4f06-a80b-7f199f7dd92e",
"mv": "chirp-v4",
"msg": "",
"tags": "emotional punk",
"state": "succeeded",
"title": "City Lights",
"prompt": "[Verse]\nWalking down the streets\nBeneath the city lights\nNeon signs flickering\nLighting up the night\nHeart beating faster\nLike a drum in my chest\nI’m alive in this moment\nFeeling so blessed\n\nStilettos on the pavement\nStepping with grace\nSurrounded by the people\nMoving at their own pace\nThe rhythm of the city\nIt pulses in my veins\nLost in the energy\nAs my worries drain\n\n[Verse 2]\nConcrete jungle shining\nWith its dazzling glow\nEvery corner hiding secrets that only locals know\nA symphony of chaos\nBut it’s music to my ears\nThe hustle and the bustle\nWiping away my fears",
"status": "complete",
"clip_id": "a6bd6a70-4cde-4f06-a80b-7f199f7dd92e",
"task_id": "ba46ad15-07ce-41a6-b68d-196321dc00d5_2",
"duration": 201,
"audio_url": "https://cdn1.suno.ai/a6bd6a70-4cde-4f06-a80b-7f199f7dd92e.mp3",
"image_url": "https://cdn2.suno.ai/image_a6bd6a70-4cde-4f06-a80b-7f199f7dd92e.jpeg",
"video_url": "https://cdn1.suno.ai/a6bd6a70-4cde-4f06-a80b-7f199f7dd92e.mp4",
"continue_at": null,
"create_time": "1733717599",
"update_time": "1733717762",
"image_large_url": "https://cdn2.suno.ai/image_large_a6bd6a70-4cde-4f06-a80b-7f199f7dd92e.jpeg",
"continue_clip_id": null,
"gpt_description_prompt": null
}
]
}
}