API Doc-CometAPI
HomeDashBoardModel_Price
HomeDashBoardModel_Price
Discord_Support
  1. Suno
  • GET START
    • Model New Release Announcement
    • Platform notification
    • Help Center
    • Quick Start
    • About Pricing
    • About Grouping
    • Interface Stability
    • Privacy policy
    • Terms of service
    • Error code description
    • Code example
    • Must see for use
    • Common Misconceptions
    • Confusion about use
    • Best Practices
      • CometAPI Account Balance Query API Usage Instructions
      • Retry Logic Documentation for CometAPI and OpenAI Official API
      • Midjourney Best Practices
      • Runway Best Practices
  • OpenAI Compatiable Endpoint
    • gpt-4o-image generates image
    • Chat
    • Recognizing Images
    • Models
    • Embeddings
    • Images
    • Realtime
    • Image Editing (gpt-image-1)
    • response
  • Audio
    • Create speech
    • Create transcription
    • Create translation
  • Anthropic Compatiable Endpoint
    • Anthropic Claude
  • Music Generation Endpoint
    • Suno
      • Setting suno Version
      • Generate lyrics
      • Generate music clip
      • Upload clip
      • Submit concatenation
      • Single task query
      • Batch query tasks
    • Udio(Temporarily unavailable)
      • Generate music
      • Task query
    • test
      • Suno
        • Full Track Audio Separation
          POST
        • Single Track Audio Separation
          POST
        • Create New Persona
          POST
        • Generate mp4 mv video
          GET
        • Get wav format file
          GET
        • Timing: lyrics, audio timeline
          GET
        • Create music using persona_id
          POST
  • Image Generation Endpoint
    • Midjourney(images)
      • Quick Tutorial - Complete Process in One Go
      • Task Fetching API
        • List by Condition
        • Fetch Single Task (most recommended)
      • Imagine
      • Submit Video
      • Action (UPSCALE; VARIATION; REROLL; ZOOM, etc.)
      • Blend (image -> image)
      • Describe (image -> text)
      • Modal (Area Redesign & Zoom)
    • 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)
      • Generate image (replicate format)
      • flux fine-tune images(Temporarily unavailable)
      • flux generate image(Temporarily unavailable)
      • flux query
    • Replicate(image)
      • replicate Generate
      • replicate query
    • Recraft(images)
      • Appendix
      • Recraft Generate Image
      • Recraft Vectorize Image
      • Recraft Remove Background
      • Recraft Clarity Upscale
      • Recraft Create style
      • Recraft Generative Upscale
  • Video Generation Ednpoint
    • veo3
      • veo3
    • runway(video)
      • official format
        • runway images raw video
        • runway to get task details
      • Reverse Format
        • generate(text)
        • generate(Reference images)
        • Video to Video Style Redraw
        • Act-one Expression Migration
        • feed-get task
    • kling (video)
      • callback_url
      • Expanded
      • Generating images
      • Text Generation Video
      • Image Generation Video
      • Video Extension
      • virtual try-on
      • lip sync
      • effects
      • Individual queries (videos)
    • MiniMax Conch(video)
      • MiniMax Conch Official Documentation
      • MiniMax Conch Generation
      • MiniMax Conch Query
      • MiniMax Conch Download
    • luma (video)
      • Official api interface format
        • luma generate
        • luma search
    • PIKA(video)
      • pika feed
      • PIKA Reference Video Generation
      • PIKA Reference Image Generation
      • PIKA reference text generation
    • sora
      • Reverse Format
        • Create Video
        • Query Video Task
        • Create Video
  • 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
  1. Suno

Create music using persona_id

Testing
POST
https://api.cometapi.com/suno/generate
Maintainer:Not configured
Note that mv is chirp-v3-5-tau or chirp-v4-tau or chirp-auk
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
}
Previous
Timing: lyrics, audio timeline
Next
Quick Tutorial - Complete Process in One Go
Built with