API Doc-CometAPI
English
  • English
  • Русский
HomeDashBoardModel Marketplace
HomeDashBoardModel Marketplace
Discord_Support
English
  • English
  • Русский
  1. Suno
  • How to Use CometAPI?
  • 🚀 Overview
    • Quick Start
    • Important Guidelines
    • Release Notes
    • Quickly request CometAPI via ApiDog
    • Models
  • 💬 Text Models
    • Chat
    • Responses
    • Anthropic Messages
    • Gemini Generating Content
    • Embeddings
  • 🖼️ Image Models
    • OpenAI
      • gpt-4o-image generates image
      • Images
      • Image Editing (gpt-image-1)
    • Gemini
      • Guide to calling gemini-3-pro-image (Nano Banana)
      • Gemini generates image
    • Midjourney
      • Midjourney Quick Start: Complete Image Generation Workflow in One Go
      • Task Fetching API
        • List by Condition
        • Fetch Single Task (most recommended)
      • Imagine
      • Submit Video
      • Submit Editor
      • Action (UPSCALE; VARIATION; REROLL; ZOOM, etc.)
      • Blend (image -> image)
      • Describe (image -> text)
      • Modal (Area Redesign & Zoom)
    • Replicate(image)
      • Create Predictions - General
      • replicate query
    • seededit/seedream
      • bytedance-Image Editing (seededit)
      • bytedance-image-generation(seedream)
    • bria
      • Generate Image
      • Generate Vector Graphics - Base (Beta)
      • Image Editing
      • Query Status
    • Hunyuan3D
  • 📺 Video Models
    • sora-2
      • official
        • Create video
        • Remix video
        • Retrieve video
        • Retrieve video content
      • self-developed
        • Retrieve video
        • Create video
    • veo3
      • veo3-chat format
      • Submit video generation task
      • Query video generation status
    • kling (video)
      • callback_url
      • Multimodal Video Editing
        • Initialize Video for Editing
        • Add Video Selection
        • Delete Video Selection
        • Clear Video Selection
        • Preview Selected Video Area
        • Create Task
      • Text to Video
      • Image to Video
      • Multi-Image To Video
      • Video Extension
      • Avatar
      • Lip-Sync
      • Video Effects
      • Text to Audio
      • Video to Audio
      • TTS
      • Image Generation
      • Multi-Image to Image
      • Image Expansion
      • Image Recognize
      • Virtual Try-On
      • [Counterpart] Creating Tasks
      • lip sync
      • Individual queries
    • runway(video)
      • official format
        • runway images raw video
        • Generate a video from a video
        • Generate an image from text
        • Upscale a video
        • Control a character
        • runway to get task details
      • Reverse Format
        • generate(text)
        • generate(Reference images)
        • Video to Video Style Redraw
        • Act-one Expression Migration
        • feed-get task
    • bytedance
      • bytedance-video
      • bytedance-video get
    • MiniMax Conch(video)
      • MiniMax Conch Official Documentation
      • MiniMax Conch Generation
      • MiniMax Conch Query
      • MiniMax Conch Download
  • 🎵 Music Models
    • Suno
      • Setting suno Version
      • Suno API Scenario Application Guide
      • upload
      • Generate lyrics
        POST
      • Generate music clip
        POST
      • Upload clip
        POST
      • Submit concatenation
        POST
      • Full Track Audio Separation
        POST
      • Single Track Audio Separation
        POST
      • Create New Persona
        POST
      • add style tags
        POST
      • Single task query
        GET
      • Generate mp4 mv video
        GET
      • Timing: lyrics, audio timeline
        GET
      • Get wav format file
        GET
      • Get midi
        GET
      • Batch query tasks
        POST
  • 🔊 Audio Models
    • Realtime
    • Create speech
    • Create transcription
    • Create translation
  • 🧩 Integration Guides
    • LiteLLM
    • Dify
    • Make
    • n8n
    • Lobe-Chat
    • COZE
    • Zapier
    • Activepieces
    • LlamaIndex
    • Continue
    • FlowiseAI
    • Chatbox
    • CherryStudio
    • AnythingLLM
    • LangChain
    • BuildShip
    • gptme
    • Immersive Translation
    • Cline
    • Eudic Translation
    • ChatHub
    • OpenAI Translator
    • ChatAll Translation
    • Pot Translation
    • Zotero
    • NEXT CHAT (ChatGPT Next Web)
    • Obsidian's Text Generator Plugin
    • librechat
    • utools-ChatGPT Friend
    • avante.nvim
    • Open WebUI
    • GPT Academic Optimization (gpt_academic)
    • OpenManus
    • IntelliJ Translation Plugin
    • FastGPT
    • n8n Local Deployment
  • ⚠️ Errors
    • Error Codes & Handling
  • 📝 Code Examples
    • Text-to-Image Generation
    • Image-to-image generation URL upload
    • Regular Post Text Conversation
    • OpenAI Official Library Usage Example
    • Streamed Output
    • Json Fixed Format Output Code Display
    • Embedding code example
    • o1-preview Model Code Example
    • LangChain Usage Example (Successful Test Date: 2024-11-25)
    • Openai dall-e-3 & flux series drawing model
    • gpt, claude, gemini multimodal network image parsing example
    • Multimodal PDF File Parsing Examples for GPT, Claude, and Gemini
    • Code example
  • 🏄🏼‍♀️ Best Practices
    • Midjourney Best Practices
    • Retry Logic Documentation for CometAPI and OpenAI Official API
    • Runway Best Practices
    • Claude Code Installation and Usage Guide
    • Gemini CLI Installation and Usage Guide
    • Codex Usage Guide
    • CometAPI Account Balance Query API Usage Instructions
  • 💳 Pricing & Billing
    • About Pricing
  • 🤝🏼 Support
    • Help Center
    • Interface Stability
    • Privacy policy
    • Terms of service
    • Common Misconceptions
    • Confusion about use
  1. Suno

Generate music clip

POST
https://api.cometapi.com/suno/submit/music
Maintainer:Not configured

Generate music clip#

The /suno/submit/music endpoint allows you to generate music clips with specific details. There are six modes which can be useful for different scenarios.
💡 Complete Request Examples: We have provided comprehensive JSON request examples for all six modes in the code examples section below. Please refer to these examples for detailed parameter usage and structure.

Modes#

1.
Inspiration Mode: Only requires a topic - both lyrics and music style will be decided by AI.
2.
Custom Mode: Requires lyrics, music style and song title to create your custom piece of music.
3.
Song Continuation: Almost the same parameters as the custom mode but with a few additional parameters for locating your previous music clips and continuing generation based on your instructions: task_id, continue_clip_id, continue_at, task.
4.
Persona Mode: Create music using a specific artist persona with consistent style.
5.
Dubbing Mode: Add instrumental underpainting to existing audio.
6.
Lyrics Mode: Add vocal overpainting to existing instrumental tracks.

1. Inspiration Mode#

gpt_description_prompt (string): The prompt for the music generation. It's basically a sentence or a few words describing what you want your song to be about.
mv (string): The version of the music model (e.g., chirp-auk).

2. Custom Mode#

prompt (string): The lyrics for the music submission.
tags (string): Music style tags associated with the submission.
mv (string): The version of the music model (e.g., chirp-v4).
title (string): The title of the music submission.

3. Song Continuation#

prompt (string): The lyrics for the music continuation.
tags (string): Music style tags associated with the submission.
negative_tags (string): Tags to avoid in the music generation.
mv (string): The version of the music model.
title (string): The title of the music submission.
task_id (string): Identifier for the original task.
continue_clip_id (string): Identifier for the clip to continue from.
continue_at (number): Position (in seconds) to continue from in the music.
task (string): Must be set to "extend".

4. Create Music Using Persona#

Create music with a consistent artist style using a previously created persona.
prompt (string): The lyrics for the music submission.
generation_type (string): Type of generation (e.g., "TEXT").
tags (string): Music style tags.
negative_tags (string): Tags to avoid.
mv (string): The version of the music model.
title (string): The title of the music submission.
task_id (string): Identifier for the task.
task (string): Task type identifier.
persona_id (string): The persona identifier obtained from the Create Persona endpoint.
artist_clip_id (string): The clip ID from a previous music generation.
⚠️ Important Notes for Persona Mode:
mv must be one of: chirp-v3-5-tau, chirp-v4-tau, or chirp-auk
task must be set to "artist_consistency"
persona_id is the ID obtained from the Create New Persona endpoint
artist_clip_id is the clip_id from a previous music generation step

5. Dubbing Mode (Underpainting)#

Add instrumental backing to existing audio content.
mv (string): The version of the music model (e.g., chirp-bluejay).
tags (string): Detailed description of the desired instrumental style.
title (string): The title of the output.
underpainting_clip_id (string): The clip ID to add underpainting to.
underpainting_start_s (number): Start time in seconds.
underpainting_end_s (number): End time in seconds.
task (string): Must be set to "underpainting".
prompt (string): Can be empty for instrumental-only generation.
override_fields (array): Fields to override (e.g., ["prompt", "tags"]).

6. Lyrics Mode (Overpainting)#

Add vocal layers to existing instrumental tracks.
mv (string): The version of the music model (e.g., chirp-bluejay).
tags (string): Detailed description of the desired vocal style and musical characteristics.
title (string): The title of the output.
overpainting_clip_id (string): The clip ID to add vocals to.
overpainting_start_s (number): Start time in seconds.
overpainting_end_s (number): End time in seconds.
task (string): Must be set to "overpainting".
prompt (string): The lyrics to be sung.
override_fields (array): Fields to override (e.g., ["prompt", "tags"]).

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Successful Response
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST 'https://api.cometapi.com/suno/submit/music' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '1. Inspiration Mode

{
    "mv": "chirp-auk",
    "gpt_description_prompt": "cat"
}

2.Customization Mode
{
    "prompt": "[Verse]\nWalking down the streets\nBeneath the city lights\nNeon signs flickering\nLighting up the night\nHeart beating faster\nLike a drum in my chest\nI'\''m alive in this moment\nFeeling so blessed\n\nStilettos on the pavement\nStepping with grace\nSurrounded by the people\nMoving at their own pace\nThe rhythm of the city\nIt pulses in my veins\nLost in the energy\nAs my worries drain\n\n[Verse 2]\nConcrete jungle shining\nWith its dazzling glow\nEvery corner hiding secrets that only locals know\nA symphony of chaos\nBut it'\''s music to my ears\nThe hustle and the bustle\nWiping away my fears",
    "tags": "emotional punk",
    "mv": "chirp-v4",
    "title": "City Lights"
}

3. Continued
{
    "prompt": "[Verse]\nWalking down the streets\nBeneath the city lights\nNeon signs flickering\nLighting up the night\nHeart beating faster\nLike a drum in my chest\nI'\''m alive in this moment\nFeeling so blessed\n\nStilettos on the pavement\nStepping with grace\nSurrounded by the people\nMoving at their own pace\nThe rhythm of the city\nIt pulses in my veins\nLost in the energy\nAs my worries drain\n\n[Verse 2]\nConcrete jungle shining\nWith its dazzling glow\nEvery corner hiding secrets that only locals know\nA symphony of chaos\nBut it'\''s music to my ears\nThe hustle and the bustle\nWiping away my fears",
    "tags": "bass-driven atmospheric heavy metal",
    "negative_tags": "dance",
    "mv": "chirp-v4",
    "title": "City Lights",
    "task_id": "736a6f88-bd29-4b1e-b110-37132a5325ac",
    "continue_clip_id": "736a6f88-bd29-4b1e-b110-37132a5325ac_1",
    "continue_at": 80,
    "task": "extend"
}

4.Create music using persona_id
*   **Notes:**
 *  mv should be chirp-v3-5-tau or chirp-v4-tau or chirp-auk
 *  task should be artist_consistency
 *  persona_id is the returned id obtained from the create persona interface step
 *  artist_clip_id is the clip_id from the generate music step

{
    "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_id": "f8fa553b-62a5-4091-9b5f-06e6f8817976",
    "task": "artist_consistency",
    "persona_id": "05bf9685-ab17-4b3b-93f6-0537f13f9e17",
    "artist_clip_id": "bd9cfdee-2010-4fdd-ab08-eaa6ac6a86d8"
}

5. Dubbing: {
    "mv": "chirp-bluejay",
    "tags": "Pop rap, uplifting, magnetic male vocals, piano, synth, electric guitar, driving bass, clear structure",
    "title": "Hi Insterumental",
    "underpainting_clip_id": "3c332c7c-85e5-4d36-9949-9af0521af891",
    "underpainting_start_s": 0,
    "underpainting_end_s": 37.9,
    "task": "underpainting",
    "prompt": "",
    "override_fields": [
        "prompt",
        "tags"
    ]
}
6. Lyrics: {
    "mv": "chirp-bluejay",
    "tags": "A smooth, soulful R&B track with a moderate tempo and a relaxed, laid-back feel. The instrumentation features a clean electric guitar playing arpeggiated chords, a prominent bass guitar providing a walking bass line, and a drum kit with a soft, brushed snare sound. The male lead vocal is smooth and melodic, with a baritone range and a slightly melancholic tone. The song is in a minor key, contributing to its introspective mood. Production elements include a subtle reverb on the vocals and guitar, creating a spacious and intimate atmosphere. The song structure follows a typical verse-chorus format with a clear melodic progression.",
    "title": "Hi vocal",
    "overpainting_clip_id": "3c332c7c-85e5-4d36-9949-9af0521af891",
    "overpainting_start_s": 0,
    "overpainting_end_s": 37.9,
    "task": "overpainting",
    "prompt": "yourself ",
    "override_fields": [
        "prompt",
        "tags"
    ]
}'
Response Response Example
{
    "code": "success",
    "message": "",
    "data": "736a6f88-bd29-4b1e-b110-37132a5325ac"
}
Modified at 2025-11-21 09:29:39
Previous
Generate lyrics
Next
Upload clip
Built with