- GET START
- OpenAI Compatiable Endpoint
- Audio
- Anthropic Compatiable Endpoint
- Music Generation Endpoint
- Suno
- Udio(Temporarily unavailable)
- test
- Image Generation Endpoint
- 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)
- Video Generation Ednpoint
- Software Integration Guide
- 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
Create music using persona_id
Testing
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
}