查询歌曲
方法: GET路径: /suno/fetch/{task_id}
请求参数
Path 参数
text
task_id
string
任务ID
必需Header 参数
text
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}请求示例代码
Shell
bash
curl --location --request GET '/suno/fetch/' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}'返回响应
🟢 200 成功
内容类型: application/json
响应结构
text
code
string
必需
message
string
必需
data
object
必需
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]
必需示例
json
{
"code": "success",
"message": "",
"data": {
"task_id": "f4a94d75-087b-4bb1-bd45-53ba293faf96",
"notify_hook": "",
"action": "LYRICS",
"status": "SUCCESS",
"fail_reason": "",
"submit_time": 1716192124,
"start_time": 1716192124,
"finish_time": 1716192124,
"progress": "100%",
"data": [
{
"id": "7a4bde37-f81a-4af2-a8a6-0d0c92f745b8",
"tags": "acoustic vibes, whimsical, playful, female vocals",
"state": "succeeded",
"title": "Feline Reverie",
"handle": "croora5o",
"prompt": "[Verse]\nPaws tap-dance on the wooden floor\nWhiskered mischief I adore\nA tail that flicks like a metronome\nThis feline world feels like my home\n\n[Chorus]\nOh cat oh cat you're a mystery\nA stealthy shadow in history\nYou pounce you prance a royal spree\nThe queen of pets you’ll always be\n\n[Verse 2]\nEyes like jewels they pierce my soul\nSilent watcher never extols\nA leap a stretch a quiet yawn\nYou rule the night and greet the dawn\n\n[Bridge]\nThe sofa's yours the bed is shared\nEvery snack must be declared\nA conqueror in a tiny size\nYou’ve claimed my heart no compromise\n\n[Verse 3]\nA paper bag you’ve turned to gold\nA cozy nook you love to hold\nFrom lofty perch you gaze on down\nIn your soft paws resides my crown\n\n[Chorus]\nOh cat oh cat you're a mystery\nA stealthy shadow in history\nYou pounce you prance a royal spree\nThe queen of pets you’ll always be",
"status": "complete",
"clip_id": "7a4bde37-f81a-4af2-a8a6-0d0c92f745b8",
"duration": 198.76,
"is_liked": false,
"metadata": {
"tags": "acoustic vibes, whimsical, playful, female vocals",
"type": "gen",
"prompt": "[Verse]\nPaws tap-dance on the wooden floor\nWhiskered mischief I adore\nA tail that flicks like a metronome\nThis feline world feels like my home\n\n[Chorus]\nOh cat oh cat you're a mystery\nA stealthy shadow in history\nYou pounce you prance a royal spree\nThe queen of pets you’ll always be\n\n[Verse 2]\nEyes like jewels they pierce my soul\nSilent watcher never extols\nA leap a stretch a quiet yawn\nYou rule the night and greet the dawn\n\n[Bridge]\nThe sofa's yours the bed is shared\nEvery snack must be declared\nA conqueror in a tiny size\nYou’ve claimed my heart no compromise\n\n[Verse 3]\nA paper bag you’ve turned to gold\nA cozy nook you love to hold\nFrom lofty perch you gaze on down\nIn your soft paws resides my crown\n\n[Chorus]\nOh cat oh cat you're a mystery\nA stealthy shadow in history\nYou pounce you prance a royal spree\nThe queen of pets you’ll always be",
"stream": true,
"duration": 198.76,
"is_remix": false,
"priority": 0,
"can_remix": true,
"refund_credits": false,
"free_quota_category": "web_v4_gen",
"gpt_description_prompt": "cat"
},
"audio_url": "https://cdn1.suno.ai/7a4bde37-f81a-4af2-a8a6-0d0c92f745b8.mp3",
"image_url": "https://cdn2.suno.ai/image_7a4bde37-f81a-4af2-a8a6-0d0c92f745b8.jpeg",
"is_public": false,
"video_url": "https://cdn1.suno.ai/7a4bde37-f81a-4af2-a8a6-0d0c92f745b8.mp4",
"created_at": "2025-05-05T15:03:51.024Z",
"flag_count": 0,
"is_trashed": false,
"model_name": "chirp-v4",
"play_count": 0,
"entity_type": "song_schema",
"display_name": "croora5o",
"upvote_count": 0,
"comment_count": 0,
"allow_comments": true,
"image_large_url": "https://cdn2.suno.ai/image_large_7a4bde37-f81a-4af2-a8a6-0d0c92f745b8.jpeg",
"avatar_image_url": "https://cdn1.suno.ai/sAura19.jpg",
"is_handle_updated": false,
"major_model_version": "v4",
"is_following_creator": false
},
{
"id": "375c0c33-988c-4178-98aa-25613f1b763c",
"tags": "acoustic vibes, whimsical, playful, female vocals",
"state": "succeeded",
"title": "Feline Reverie",
"handle": "croora5o",
"prompt": "[Verse]\nPaws tap-dance on the wooden floor\nWhiskered mischief I adore\nA tail that flicks like a metronome\nThis feline world feels like my home\n\n[Chorus]\nOh cat oh cat you're a mystery\nA stealthy shadow in history\nYou pounce you prance a royal spree\nThe queen of pets you’ll always be\n\n[Verse 2]\nEyes like jewels they pierce my soul\nSilent watcher never extols\nA leap a stretch a quiet yawn\nYou rule the night and greet the dawn\n\n[Bridge]\nThe sofa's yours the bed is shared\nEvery snack must be declared\nA conqueror in a tiny size\nYou’ve claimed my heart no compromise\n\n[Verse 3]\nA paper bag you’ve turned to gold\nA cozy nook you love to hold\nFrom lofty perch you gaze on down\nIn your soft paws resides my crown\n\n[Chorus]\nOh cat oh cat you're a mystery\nA stealthy shadow in history\nYou pounce you prance a royal spree\nThe queen of pets you’ll always be",
"status": "complete",
"clip_id": "375c0c33-988c-4178-98aa-25613f1b763c",
"duration": 119.04,
"is_liked": false,
"metadata": {
"tags": "acoustic vibes, whimsical, playful, female vocals",
"type": "gen",
"prompt": "[Verse]\nPaws tap-dance on the wooden floor\nWhiskered mischief I adore\nA tail that flicks like a metronome\nThis feline world feels like my home\n\n[Chorus]\nOh cat oh cat you're a mystery\nA stealthy shadow in history\nYou pounce you prance a royal spree\nThe queen of pets you’ll always be\n\n[Verse 2]\nEyes like jewels they pierce my soul\nSilent watcher never extols\nA leap a stretch a quiet yawn\nYou rule the night and greet the dawn\n\n[Bridge]\nThe sofa's yours the bed is shared\nEvery snack must be declared\nA conqueror in a tiny size\nYou’ve claimed my heart no compromise\n\n[Verse 3]\nA paper bag you’ve turned to gold\nA cozy nook you love to hold\nFrom lofty perch you gaze on down\nIn your soft paws resides my crown\n\n[Chorus]\nOh cat oh cat you're a mystery\nA stealthy shadow in history\nYou pounce you prance a royal spree\nThe queen of pets you’ll always be",
"stream": true,
"duration": 119.04,
"is_remix": false,
"priority": 0,
"can_remix": true,
"refund_credits": false,
"free_quota_category": "web_v4_gen",
"gpt_description_prompt": "cat"
},
"audio_url": "https://cdn1.suno.ai/375c0c33-988c-4178-98aa-25613f1b763c.mp3",
"image_url": "https://cdn2.suno.ai/image_375c0c33-988c-4178-98aa-25613f1b763c.jpeg",
"is_public": false,
"video_url": "https://cdn1.suno.ai/375c0c33-988c-4178-98aa-25613f1b763c.mp4",
"created_at": "2025-05-05T15:03:51.024Z",
"flag_count": 0,
"is_trashed": false,
"model_name": "chirp-v4",
"play_count": 0,
"entity_type": "song_schema",
"display_name": "croora5o",
"upvote_count": 0,
"comment_count": 0,
"allow_comments": true,
"image_large_url": "https://cdn2.suno.ai/image_large_375c0c33-988c-4178-98aa-25613f1b763c.jpeg",
"avatar_image_url": "https://cdn1.suno.ai/sAura19.jpg",
"is_handle_updated": false,
"major_model_version": "v4",
"is_following_creator": false
}
]
}
}