- 指南
- 获取 Base URL 和 API Key
- 通知设置-WebHook参数介绍
- 配置方式
- 列出模型
- 聊天(Chat)
- RAG(嵌入、重排序
- 视频模型
- 数字人
- 绘图模型
- 生图模型简介
- OpenAI Dall-e 格式
- OpenAI 聊天格式
- Mid journey 文生图
- Flux 文生图
- Ideogram(官方格式
- recraft 官方格式
- 快手可 灵(官方格式)
- SeedEdit(图片编辑
- Replicate
- 接入教程
- 获取任务进度（predictions (免费
- 创建任务-通过模型version（predictions）
- 创建任务-通过url路径
- 创建任务-stability-ai/stable-diffusion
- 创建任务-stability-ai/sdxl
- 创建任务-stability-ai/stable-diffusion-inpainting
- 创建任务-stability-ai/stable-diffusion-img2img
- 创建任务-lucataco/flux-schnell-lora
- 创建任务-lucataco/flux-dev-lora
- 创建任务-andreasjansson/stable-diffusion-animation
- 创建任务-lucataco/animate-diff
- 创建任务-sujaykhandekar/object-removal
- 创建任务-cjwbw/rembg
- 创建任务-black-forest-labs/flux-1.1-pro
- 创建任务-black-forest-labs/flux-1.1-pro-ultra
- 创建任务-black-forest-labs/flux-dev
- 创建任务-black-forest-labs/flux-pro
- 创建任务-black-forest-labs/flux-schnell
- 创建任务-minimax/video-01-live
- 创建任务-minimax/video-01
- 创建任务-recraft-ai/recraft-v3
- 创建任务-recraft-ai/recraft-v3-svg
- 创建任务-ideogram-ai/ideogram-v2-turbo
- 豆包智能绘图
- 音频接口
- Suno文生歌
- 补充
- 音乐生成参数介绍
- 场景一: 灵感模式
- 场景二: 自定义.歌词歌名
- 场景三: 纯音乐.自定义
- 场景四: 纯音乐.灵感模式
- 场景五: 续写自定义音频
- 场景六: 续写音乐并获取完整音乐
- 场景七: Cover 音乐翻版\修改风格
- 场景八: Replace Section.替换片段
- 场景九: Persona.歌手风格
- 场景十: 上传续写
- 生成歌曲(灵感模式)POST
- 生成歌曲(自定义模式)POST
- 生成歌曲(续写模式)POST
- 生成歌曲(歌手风格) POST
- 生成歌曲(上传歌曲二次创作)POST
- 生成歌曲(拼接歌曲)POST
- 生成歌词POST
- 上传请求POST
- 报告上传完毕POST
- 查询上传处理状态GET
- 初始化音频文件POST
- Persona:创建歌手风格POST
- 查询歌词GET
- 查询歌曲GET
- 批量获取任务POST
- 声曲分离GET
- Timing:歌词、音频时间线GET
- wav:获取 wav 格式文件GET
- mp4:生成 mp4 mv 视频GET
- 上传音乐通过 urlPOST
- 生成歌曲 (v1 版本)POST
- 拼接歌曲 (v1 版本)POST
- 生成歌词 (v1 版本)POST
- 查询歌曲 (v1 版本)GET
- 查询歌词 (v1 版本)GET
- OpenAI(TTS\Wishper
- 文件上传（Files）
- PPT接口
- 帮助中心
- 平台API
- 废弃、未开放
批量获取任务
POST
{{BASE_URL}}/suno/fetch
最后修改时间：2025-05-12 11:02:53
请求参数
Header 参数
Authorization
string
可选
示例值:
Bearer {{YOUR_API_KEY}}
Accept
string
可选
示例值:
application/json
Content-Type
string
可选
示例值:
application/json
Body 参数application/json
ids
array[string]
必需
action
string
可选
示例
{
"ids": [
"task_id"
]
}示例代码
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 '{{BASE_URL}}/suno/fetch' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
"ids": ["task_id"]
}'返回响应
🟢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"
}
]
}
]
}