š New Models Available: grok-4 now live!
ā Explore New Features
- 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
Single Track Audio Separation
POST
https://api.cometapi.com/suno/submit/music
Maintainer:Not configured
šµ Audio Track Separation Process šµ#
š Operation Steps:#
1.
task id2.
task id, obtain the corresponding clip_id value of the song as needed3.
task id and clip_id as parameters into this interface to get a new task id4.
task_id obtained in step3 to get the clip_id and corresponding url for each track after separationš” Key Notes:#
Generate Music interface notes:**mv should be chirp-auktask should be gen_stemcontinue_clip_id is the clip_id from step 2stem_type_group_name should be Twostem_task should be twoš° Billing Details:#
Request
Header Params
Authorization
stringĀ
required
Example:
Bearer {{api-key}}
Body Params application/json
task
stringĀ
required
task_id
stringĀ
required
generation_type
stringĀ
required
title
stringĀ
required
mv
stringĀ
required
make_instrumental
booleanĀ
required
continue_clip_id
stringĀ
required
continued_aligned_prompt
nullĀ
required
continue_at
nullĀ
required
stem_type_id
integerĀ
required
stem_type_group_name
stringĀ
required
stem_task
stringĀ
required
Example
{
"task": "gen_stem",
"generation_type": "TEXT",
"title": "Security String",
"mv": "chirp-auk",
"prompt": "",
"make_instrumental": true,
"task_id": "482eafdd-965c-4e04-81f5-9fe099fa012e",
"continue_clip_id": "c329e25b-ea7e-45af-87a2-40fef81e597b",
"continued_aligned_prompt": null,
"continue_at": null,
"stem_type_id": 91,
"stem_type_group_name": "Two",
"stem_task": "two"
}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/submit/music' \
--header 'Authorization: Bearer {{api-key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"task": "gen_stem",
"generation_type": "TEXT",
"title": "Security String",
"mv": "chirp-auk",
"prompt": "",
"make_instrumental": true,
"task_id": "482eafdd-965c-4e04-81f5-9fe099fa012e",
"continue_clip_id": "c329e25b-ea7e-45af-87a2-40fef81e597b",
"continued_aligned_prompt": null,
"continue_at": null,
"stem_type_id": 91,
"stem_type_group_name": "Two",
"stem_task": "two"
}'Responses
š¢200Successful Response
application/json
Body
id
stringĀ
required
clips
arrayĀ [object {23}]Ā
required
id
stringĀ
optional
entity_type
stringĀ
optional
video_url
stringĀ
optional
audio_url
stringĀ
optional
major_model_version
stringĀ
optional
model_name
stringĀ
optional
metadata
objectĀ
optional
is_liked
booleanĀ
optional
user_id
stringĀ
optional
display_name
stringĀ
optional
handle
stringĀ
optional
is_handle_updated
booleanĀ
optional
avatar_image_url
stringĀ
optional
is_trashed
booleanĀ
optional
flag_count
integerĀ
optional
created_at
stringĀ
optional
status
stringĀ
optional
title
stringĀ
optional
play_count
integerĀ
optional
upvote_count
integerĀ
optional
is_public
booleanĀ
optional
allow_comments
booleanĀ
optional
more
stringĀ
optional
metadata
objectĀ
required
prompt
stringĀ
required
history
arrayĀ [object {8}]Ā
required
stem_from_id
stringĀ
required
stem_task
stringĀ
required
stem_type_id
integerĀ
required
stem_type_group_name
stringĀ
required
edited_clip_id
stringĀ
required
type
stringĀ
required
stream
booleanĀ
required
infill
booleanĀ
required
task
stringĀ
required
can_remix
booleanĀ
required
is_remix
booleanĀ
required
priority
integerĀ
required
major_model_version
stringĀ
required
status
stringĀ
required
created_at
stringĀ
required
batch_size
integerĀ
required
Example
{
"id": "b19ee87f-574d-42c7-9761-df6aafc0fd9c",
"clips": [
{
"id": "0e5be1db-4834-4890-acfb-2fea7fd24eb9",
"entity_type": "song_schema",
"video_url": "",
"audio_url": "",
"major_model_version": "",
"model_name": "chirp-stem",
"metadata": {
"prompt": "",
"history": [
{
"id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
"type": "gen",
"source": "web",
"infill": false,
"stem_type_id": 91,
"stem_type_group_name": "Twelve",
"stem_task": "twelve",
"stem_from_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc"
}
],
"stem_from_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
"stem_task": "twelve",
"stem_type_id": 91,
"stem_type_group_name": "Vocals",
"edited_clip_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
"type": "gen",
"stream": true,
"infill": false,
"task": "gen_stem",
"can_remix": true,
"is_remix": false,
"priority": 10
},
"is_liked": false,
"user_id": "a8a4d117-d5aa-4a9f-ab5b-88cc2c2eb79d",
"display_name": "ugknurymt91r",
"handle": "ugknurymt91r",
"is_handle_updated": false,
"avatar_image_url": "https://cdn1.suno.ai/sAura20.jpg",
"is_trashed": false,
"flag_count": 0,
"created_at": "2025-06-06T11:22:30.753Z",
"status": "submitted",
"title": "Security String (Vocals)",
"play_count": 0,
"upvote_count": 0,
"is_public": false,
"allow_comments": true
},
{
"more": "There are 24 things like this."
}
],
"metadata": {
"prompt": "",
"history": [
{
"id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
"type": "gen",
"source": "web",
"infill": false,
"stem_type_id": 91,
"stem_type_group_name": "Twelve",
"stem_task": "twelve",
"stem_from_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc"
}
],
"stem_from_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
"stem_task": "twelve",
"stem_type_id": 91,
"stem_type_group_name": "Twelve",
"edited_clip_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
"type": "gen",
"stream": true,
"infill": false,
"task": "gen_stem",
"can_remix": true,
"is_remix": false,
"priority": 10
},
"major_model_version": "",
"status": "complete",
"created_at": "2025-06-06T11:22:30.737Z",
"batch_size": 1
}