🇨🇳 Chinese
🇨🇳 Chinese
- 系统内部接口
- OpenAI
- Anthropic
- Suno（音乐）
- 场景一：续写音乐并获取完整音乐
- 场景二：Cover 音乐:音乐翻版\修改风格
- 场景三：Replace Section:替换片段
- 场景四：Persona:歌手风格
- 场景五：stems:声曲分离(仅限chirp_auk)
- 场景六：Timing:歌词、音频时间线(仅限chirp_auk)
- 场景七：wav:获取 wav 格式文件
- 场景八：mp4:生成 mp4 mv 视频(仅限chirp_auk)
- 生成音乐POST
- 上传音乐POST
- 歌曲拼接POST
- 新建 PersonaPOST
- 声曲分离GET
- Timing:歌词、音频时间线GET
- 获取 wav 格式文件GET
- 生成 mp4 mv 视频GET
- 生成歌词POST
- 查询单个任务GET
- 批量查询任务POST
- 批量查询歌曲GET
- Udio（音乐）
- Midjourney API文档（生图）
- Flux（生图）
- Recraft（生图）
- Ideogram（生图）
- Luma（视频）
- Runway（视频）
- PIKA（视频）
- 可灵API（官方接口）
- Replicate 通用接口
- MiniMax海螺（视频）
查询单个任务
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
}
]
}
}