歌曲任务查询接口
开发中
正式环境（默认全球加速）
https://api.sunohub.cn
正式环境（默认全球加速）
https://api.sunohub.cn
POST
https://api.sunohub.cn
最后修改时间：2025-04-13 04:20:36
请求参数
Header 参数
Authorization
string
用户的使用凭证
示例值:
Bearer {{API_TOKEN}}
Body 参数application/json
id
string
必需
action
string
必需
ids
array[string]
必需
示例
{
"id": "10b2fcd81190469fb84df0080f3f3e08",
"action": "retrieve"
}示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.sunohub.cn/suno/tasks' \
--header 'Authorization: Bearer asdasdasda9998fads' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
"id": "10b2fcd81190469fb84df0080f3f3e08",
"action": "retrieve"
}'返回响应
🟢200成功
application/json
Body
id
string
必需
api_id
string
必需
application_id
string
必需
created_at
number
必需
credential_id
string
必需
request
object
必需
action
string
必需
prompt
string
必需
model
string
必需
custom
boolean
必需
instrumental
boolean
必需
callback_url
string
必需
trace_id
string
必需
type
string
必需
user_id
string
必需
response
object
必需
success
boolean
必需
task_id
string
必需
trace_id
string
必需
data
array [object {12}]
必需
示例
{
"_id": "67ebb4ae24da382e9dff1777",
"id": "ef9f9b49-3111-46dc-84ff-5677857d3ad8",
"api_id": "dc2df3b3-a9ad-462b-b61c-1e9ee536196d",
"application_id": "43345f5b-d422-4369-9483-1a0295210365",
"created_at": 1743500462.088,
"credential_id": "c7e560cd-cac2-452d-8336-ec35c00e247d",
"request": {
"action": "generate",
"prompt": "A song for Christmas",
"model": "chirp-v4",
"custom": false,
"instrumental": false,
"callback_url": "www.baidu.com"
},
"trace_id": "ebbc12bf-d65a-41c0-b36f-5308e4f4dfba",
"type": "audios",
"user_id": "7150c9cd-2dd2-4902-a4e0-91b723a73539",
"response": {
"success": true,
"task_id": "ef9f9b49-3111-46dc-84ff-5677857d3ad8",
"trace_id": "ebbc12bf-d65a-41c0-b36f-5308e4f4dfba",
"data": [
{
"id": "acf14671-d6a4-4aec-9d93-82267d4ca9a0",
"title": "Jingle While We Wander",
"image_url": "https://cdn2.suno.ai/image_acf14671-d6a4-4aec-9d93-82267d4ca9a0.jpeg",
"lyric": "[Verse]\nSnowflakes are falling on my old blue shoes\nThe lights are twinkling in reds and blues\nI’ve got no sleigh but I’m headin’ down\nTo the brightest glow in this snowy town\n[Verse 2]\nI’m wrapping my scarf ‘round these cold\nRed cheeks\nWith bells a-ringing\nJoy’s all I seek\nCandles on windows\nA warm\nSoft gleam\nIt’s the season of hope\nThe perfect dream\n[Chorus]\nJingle while we wander through frosted nights\nFilling every corner with sparkly lights\nHold your loved ones close as the carols soar\nIt’s the magic of Christmas we all adore\n[Verse 3]\nMilk and cookies on a tray near the fire\nStockings hung with a quiet desire\nFor a morning smile\nA surprise unwrap\nUnderneath the tree with a silent clap\n[Bridge]\nEvery heart’s glowing like the star on high\nGood cheer spreading wide as the tinsel flies\nNo matter the weather or how far we roam\nChristmas reminds us\nWe find our home\n[Chorus]\nJingle while we wander through frosted nights\nFilling every corner with sparkly lights\nHold your loved ones close as the carols soar\nIt’s the magic of Christmas we all adore",
"audio_url": "https://cdn1.suno.ai/acf14671-d6a4-4aec-9d93-82267d4ca9a0.mp3",
"video_url": "https://cdn1.suno.ai/acf14671-d6a4-4aec-9d93-82267d4ca9a0.mp4",
"created_at": "2025-04-01T09:41:09.110Z",
"model": "chirp-v4",
"state": "succeeded",
"prompt": "A song for Christmas",
"style": "acoustic, uplifting",
"duration": 191.76
},
{
"id": "d21ff1df-4cbb-4eba-b436-fc5f63bd1890",
"title": "Jingle While We Wander",
"image_url": "https://cdn2.suno.ai/image_d21ff1df-4cbb-4eba-b436-fc5f63bd1890.jpeg",
"lyric": "[Verse]\nSnowflakes are falling on my old blue shoes\nThe lights are twinkling in reds and blues\nI’ve got no sleigh but I’m headin’ down\nTo the brightest glow in this snowy town\n[Verse 2]\nI’m wrapping my scarf ‘round these cold\nRed cheeks\nWith bells a-ringing\nJoy’s all I seek\nCandles on windows\nA warm\nSoft gleam\nIt’s the season of hope\nThe perfect dream\n[Chorus]\nJingle while we wander through frosted nights\nFilling every corner with sparkly lights\nHold your loved ones close as the carols soar\nIt’s the magic of Christmas we all adore\n[Verse 3]\nMilk and cookies on a tray near the fire\nStockings hung with a quiet desire\nFor a morning smile\nA surprise unwrap\nUnderneath the tree with a silent clap\n[Bridge]\nEvery heart’s glowing like the star on high\nGood cheer spreading wide as the tinsel flies\nNo matter the weather or how far we roam\nChristmas reminds us\nWe find our home\n[Chorus]\nJingle while we wander through frosted nights\nFilling every corner with sparkly lights\nHold your loved ones close as the carols soar\nIt’s the magic of Christmas we all adore",
"audio_url": "https://cdn1.suno.ai/d21ff1df-4cbb-4eba-b436-fc5f63bd1890.mp3",
"video_url": "https://cdn1.suno.ai/d21ff1df-4cbb-4eba-b436-fc5f63bd1890.mp4",
"created_at": "2025-04-01T09:41:09.110Z",
"model": "chirp-v4",
"state": "succeeded",
"prompt": "A song for Christmas",
"style": "acoustic, uplifting",
"duration": 201.96
}
]
}
}