š 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
Create music using persona_id
Deprecated
POST
https://api.cometapi.com/suno/generate
Maintainer:Not configured
task is artist_consistency
persona_id is the one obtained from the new personal step
artist_clip_id is the clip_id from the new personal step
Request
Header Params
Authorization
stringĀ
required
Example:
Bearer {{api-key}}
Body Params application/json
prompt
stringĀ
required
generation_type
stringĀ
required
tags
stringĀ
required
negative_tags
stringĀ
required
mv
stringĀ
required
title
stringĀ
required
task
stringĀ
required
persona_id
stringĀ
required
artist_clip_id
stringĀ
required
Example
{
"prompt": "[Verse]\nYou're always warm by my side from dawn to dusk\nThe wind and rain don't scare me\nHolding hands and never parting\n\n[Verse 2]\nWith you here I'm not alone\nLike the stars in the night\nThe road is long, but it's not too far\nBecause you're my light\n\n[Chorus]\nHusband, husband, I love you\nYou're the only one in the world\nWhether it be in the The ends of the earth\nHeart like a shadow never leaves\n\n[Verse 3]\nYou're my haven\nEvery night I dream of you\nEven if the road ahead is hard\nEverything's beautiful with you\n\n[Chorus]\nHubby, hubby, I love you\nYou're the only one in the world\nWherever at the ends of the earth\nHeart like a shadow never leaves\n\n[Bridge]\nLife Every moment \n with you to experience \n all tomorrow is better \n because of you I am invincible",
"generation_type": "TEXT",
"tags": "electronic, pop",
"negative_tags": "",
"mv": "chirp-v4-tau",
"title": "Husband",
"task": "artist_consistency",
"persona_id": "6a40ce76-2fbe-4272-8ccb-568ed0be7eda",
"artist_clip_id": "117decaa-d0d1-4847-bcb0-9042086c433c"
}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/generate' \
--header 'Authorization: Bearer {{api-key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"prompt": "[Verse]\nYou'\''re always warm by my side from dawn to dusk\nThe wind and rain don'\''t scare me\nHolding hands and never parting\n\n[Verse 2]\nWith you here I'\''m not alone\nLike the stars in the night\nThe road is long, but it'\''s not too far\nBecause you'\''re my light\n\n[Chorus]\nHusband, husband, I love you\nYou'\''re the only one in the world\nWhether it be in the The ends of the earth\nHeart like a shadow never leaves\n\n[Verse 3]\nYou'\''re my haven\nEvery night I dream of you\nEven if the road ahead is hard\nEverything'\''s beautiful with you\n\n[Chorus]\nHubby, hubby, I love you\nYou'\''re the only one in the world\nWherever at the ends of the earth\nHeart like a shadow never leaves\n\n[Bridge]\nLife Every moment \n with you to experience \n all tomorrow is better \n because of you I am invincible",
"generation_type": "TEXT",
"tags": "electronic, pop",
"negative_tags": "",
"mv": "chirp-v4-tau",
"title": "Husband",
"task": "artist_consistency",
"persona_id": "6a40ce76-2fbe-4272-8ccb-568ed0be7eda",
"artist_clip_id": "117decaa-d0d1-4847-bcb0-9042086c433c"
}'Responses
š¢200Successful Response
application/json
Body
id
stringĀ
required
clips
arrayĀ [object {19}]Ā
required
id
stringĀ
required
video_url
stringĀ
required
audio_url
stringĀ
required
major_model_version
stringĀ
required
model_name
stringĀ
required
metadata
objectĀ
required
is_liked
booleanĀ
required
user_id
stringĀ
required
display_name
stringĀ
required
handle
stringĀ
required
is_handle_updated
booleanĀ
required
avatar_image_url
stringĀ
required
is_trashed
booleanĀ
required
created_at
stringĀ
required
status
stringĀ
required
title
stringĀ
required
play_count
integerĀ
required
upvote_count
integerĀ
required
is_public
booleanĀ
required
metadata
objectĀ
required
tags
stringĀ
required
prompt
stringĀ
required
type
stringĀ
required
stream
booleanĀ
required
has_vocal
booleanĀ
required
artist_clip_id
stringĀ
required
persona_id
stringĀ
required
task
stringĀ
required
major_model_version
stringĀ
required
status
stringĀ
required
created_at
stringĀ
required
batch_size
integerĀ
required
Example
{
"id": "2d453a5f-c539-4fe0-9a66-24058c5dfb6a",
"clips": [
{
"id": "0e6937df-64d8-41f9-82c6-b6dadc4426a8",
"video_url": "",
"audio_url": "",
"major_model_version": "v4",
"model_name": "chirp-v4",
"metadata": {
"tags": "electronic, pop",
"prompt": "[Verse]\nYou're always warm by my side from dawn to dusk\nThe wind and rain don't scare me\nHolding hands and never parting\n\n[Verse 2]\nWith you here I'm not alone\nLike the stars in the night\nThe road is long, but it's not too far\nBecause you're my light\n\n[Chorus]\nHusband, husband, I love you\nYou're the only one in the world\nWhether it be in the The ends of the earth\nHeart like a shadow never leaves\n\n[Verse 3]\nYou're my haven\nEvery night I dream of you\nEven if the road ahead is hard\nEverything's beautiful with you\n\n[Chorus]\nHubby, hubby, I love you\nYou're the only one in the world\nWherever at the ends of the earth\nHeart like a shadow never leaves\n\n[Bridge]\nLife Every moment \n with you to experience \n all tomorrow is better \n because of you I am invincible",
"type": "gen",
"stream": true,
"has_vocal": false,
"artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163",
"persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
"task": "artist_consistency"
},
"is_liked": false,
"user_id": "a3da04d5-0442-4bd3-b837-4c73ff600914",
"display_name": "TwinklingVenue1595",
"handle": "twinklingvenue1595",
"is_handle_updated": false,
"avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
"is_trashed": false,
"created_at": "2024-12-23T10:37:43.596Z",
"status": "submitted",
"title": "čå
¬",
"play_count": 0,
"upvote_count": 0,
"is_public": false
},
{
"id": "fff58de4-7ccc-4b95-937b-3b66ec07cc65",
"video_url": "",
"audio_url": "",
"major_model_version": "v4",
"model_name": "chirp-v4",
"metadata": {
"tags": "electronic, pop",
"prompt": "[Verse]\nYou're always warm by my side from dawn to dusk\nThe wind and rain don't scare me\nHolding hands and never parting\n\n[Verse 2]\nWith you here I'm not alone\nLike the stars in the night\nThe road is long, but it's not too far\nBecause you're my light\n\n[Chorus]\nHusband, husband, I love you\nYou're the only one in the world\nWhether it be in the The ends of the earth\nHeart like a shadow never leaves\n\n[Verse 3]\nYou're my haven\nEvery night I dream of you\nEven if the road ahead is hard\nEverything's beautiful with you\n\n[Chorus]\nHubby, hubby, I love you\nYou're the only one in the world\nWherever at the ends of the earth\nHeart like a shadow never leaves\n\n[Bridge]\nLife Every moment \n with you to experience \n all tomorrow is better \n because of you I am invincible",
"type": "gen",
"stream": true,
"has_vocal": false,
"artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163",
"persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
"task": "artist_consistency"
},
"is_liked": false,
"user_id": "a3da04d5-0442-4bd3-b837-4c73ff600914",
"display_name": "TwinklingVenue1595",
"handle": "twinklingvenue1595",
"is_handle_updated": false,
"avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
"is_trashed": false,
"created_at": "2024-12-23T10:37:43.596Z",
"status": "submitted",
"title": "čå
¬",
"play_count": 0,
"upvote_count": 0,
"is_public": false
}
],
"metadata": {
"tags": "electronic, pop",
"prompt": "[Verse]\nYou're always warm by my side from dawn to dusk\nThe wind and rain don't scare me\nHolding hands and never parting\n\n[Verse 2]\nWith you here I'm not alone\nLike the stars in the night\nThe road is long, but it's not too far\nBecause you're my light\n\n[Chorus]\nHusband, husband, I love you\nYou're the only one in the world\nWhether it be in the The ends of the earth\nHeart like a shadow never leaves\n\n[Verse 3]\nYou're my haven\nEvery night I dream of you\nEven if the road ahead is hard\nEverything's beautiful with you\n\n[Chorus]\nHubby, hubby, I love you\nYou're the only one in the world\nWherever at the ends of the earth\nHeart like a shadow never leaves\n\n[Bridge]\nLife Every moment \n with you to experience \n all tomorrow is better \n because of you I am invincible",
"type": "gen",
"stream": true,
"has_vocal": false,
"artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163",
"persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
"task": "artist_consistency"
},
"major_model_version": "v4",
"status": "complete",
"created_at": "2024-12-23T10:37:43.581Z",
"batch_size": 1
}