- GET START
- API Reference
- Error Codes & Handling
- Text Models-openai format
- Anthropic Compatiable
- Image Models
- Midjourney(images)
- Ideogram(images)
- Official documentation (updated in real time)
- Generate 3.0 (text to image)
- Remix 3.0 (hybrid image)
- Reframe 3.0ļ¼Reconstructionļ¼
- Replace Background 3.0ļ¼Background replacementļ¼
- Edit 3.0ļ¼Editing imagesļ¼
- ideogram Text Raw Image
- ideogram Hybrid image
- ideogram enlargement HD
- ideogram describes the image
- ideogram Edit imageļ¼(legacy)ļ¼
- Flux(images)
- Replicate(image)
- Recraft(images)
- Music Models
- Suno
- Setting suno Version
- Suno API Scenario Application Guide
- Generate lyricsPOST
- Generate music clipPOST
- Upload clipPOST
- Submit concatenationPOST
- Full Track Audio SeparationPOST
- Single Track Audio SeparationPOST
- Create New PersonaPOST
- Single task queryGET
- Generate mp4 mv videoGET
- Timing: lyrics, audio timelineGET
- Get wav format fileGET
- Batch query tasksPOST
- Create music using persona_idPOST
- Udioļ¼Temporarily unavailableļ¼
- Video Models
- Audio Models
- CODE EXAMPLES
- Guides & Tutorials
- Integration Guides
- cometapi Site API Call Testing
- OpenManus
- Chatbox
- CherryStudio
- Cursor
- ChatHub
- COZE
- FastGPT
- cline
- dify
- gptme
- Immersive Translation
- Lobe-Chat
- Zotero
- LangChain
- AnythingLLM
- Eudic Translation
- OpenAI Translator
- ChatAll Translation
- Pot Translation
- GPT Academic Optimization (gpt_academic)
- NEXT CHAT (ChatGPT Next Web)
- Obsidian's Text Generator Plugin
- Open WebUI
- avante.nvim
- librechat
- Lazy Customer Service
- utools-ChatGPT Friend
- IntelliJ Translation Plugin
- n8n
- Best Practices
- Integration Guides
- Pricing & Billing
- Support
Batch query tasks
POST
https://api.cometapi.com/suno/fetch
Maintainer:Not configured
Request
Header Params
Authorization
stringĀ
required
Example:
Bearer {{api-key}}
Body Params application/json
ids
array[string]
required
action
stringĀ
required
Example
{
"ids": [
"task_1",
"task_2",
"task_3"
],
"action": "MUSIC" // or LYRICS
}
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 --request POST 'https://api.cometapi.com/suno/fetch' \
--header 'Authorization: Bearer {{api-key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"ids": [
"task_1",
"task_2",
"task_3"
],
"action": "MUSIC" // or LYRICS
}'
Responses
š¢200Batch task fetch
application/json
Body
code
stringĀ
required
message
stringĀ
required
data
arrayĀ [object {10}]Ā
required
task_id
stringĀ
optional
notify_hook
stringĀ
optional
action
stringĀ
optional
status
stringĀ
optional
fail_reason
stringĀ
optional
submit_time
integerĀ
optional
start_time
integerĀ
optional
finish_time
integerĀ
optional
progress
stringĀ
optional
data
arrayĀ [object {10}]Ā
optional
Example
{
"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"
}
]
}
]
}