API Doc-CometAPI
English
  • English
  • Русский
HomeDashBoardModel Marketplace
HomeDashBoardModel Marketplace
Discord_Support
English
  • English
  • Русский
  1. Suno
  • 🚀 Overview
    • Quick Start
    • Important Guidelines
    • Release Notes
    • Models
  • 💬 Text Models-OpenAI Format
    • Anthropic Compatiable
      • Anthropic Claude
    • gpt-4o-image generates image
    • Image Editing (gpt-image-1)
    • response
    • Chat
    • Recognizing Images
    • Embeddings
    • Realtime
    • Images
    • Hunyuan3D
  • 🖼️ Midjourney(images)
    • Quick Tutorial - Complete Process 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)
  • 🖼️ Image Models
    • Gemini
      • Guide to calling gemini-2.5-flash-image (Nano Banana)
      • Gemini generates image
      • Gemini text dialog
    • Replicate(image)
      • Create Task - General
      • replicate query
      • Create Task -flux-kontext-pro、max
      • Create Task -flux-1.1-pro
      • Create Task -flux-1.1-pro-ultra
    • seededit/seedream
      • bytedance-image-generation(seedream)
      • bytedance-Image Editing (seededit)
    • Flux(images)
      • flux generate image(Temporarily unavailable)
      • flux fine-tune images(Temporarily unavailable)
      • flux query
      • Generate image (replicate format)
      • Create Task - General
    • Recraft(Temporarily removed)
      • Appendix
      • Recraft Vectorize Image
      • Recraft Generate Image
      • Recraft Remove Background
      • Recraft Create style
      • Recraft Generative Upscale
      • Recraft Clarity Upscale
    • Ideogram(Temporarily removed)
      • Official documentation (updated in real time)
      • ideogram Text Raw Image
      • Generate 3.0 (text to image)
      • ideogram Edit image((legacy))
      • Remix 3.0 (hybrid image)
      • ideogram Hybrid image
      • Reframe 3.0(Reconstruction)
      • ideogram enlargement HD
      • Replace Background 3.0(Background replacement)
      • ideogram describes the image
      • Edit 3.0(Editing images)
  • 🎵 Music Models
    • Suno
      • Setting suno Version
      • Suno API Scenario Application Guide
      • 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
      • 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
    • Udio(Temporarily unavailable)
      • Generate music
      • Task query
  • 📺 Video Models
    • veo3
      • veo3-chat format
      • Submit video generation task
      • Query video generation status
    • sora-2
      • official
        • Create video
        • Remix video
        • Retrieve video
        • Delete video
        • Retrieve video content
      • sora-2 generate video by chat
    • 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
    • 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
      • Generating images
      • Expanded
      • Text Generation Video
      • Image Generation Video
      • Multi-Image To Video
      • Multi-Image to Image
      • Video Extension
      • virtual try-on
      • lip sync
      • effects
      • Video to audio
      • Text to audio
      • Individual queries
    • bytedance
      • bytedance-video
      • bytedance-video get
    • MiniMax Conch(video)
      • MiniMax Conch Official Documentation
      • MiniMax Conch Generation
      • MiniMax Conch Query
      • MiniMax Conch Download
    • luma (video)(temporarily dismantle)
      • Official api interface format
        • luma generate
        • luma search
    • PIKA(temporarily dismantle)
      • pika feed
      • PIKA Reference Video Generation
      • PIKA Reference Image Generation
      • PIKA reference text generation
  • 🔊 Audio Models
    • Create speech
    • Create transcription
    • Create translation
  • ⚠️ 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
  • 🧩 Integration Guides
    • continue
    • Chatbox
    • CherryStudio
    • COMET API API Call Testing
    • Lobe-Chat
    • Cursor
    • LangChain
    • AnythingLLM
    • 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
    • Lazy Customer Service
    • utools-ChatGPT Friend
    • avante.nvim
    • Open WebUI
    • GPT Academic Optimization (gpt_academic)
    • OpenManus
    • IntelliJ Translation Plugin
    • n8n
    • FastGPT
    • COZE
    • zapier
    • LiteLLM
    • MAKE
    • n8n Local Deployment
    • buildship
    • sillytavern
    • LlamaIndex
    • activepieces
    • FlowiseAI
    • Dify
  • 🏄🏼‍♀️ Best Practices
    • Midjourney Best Practices
    • Retry Logic Documentation for CometAPI and OpenAI Official API
    • Runway Best Practices
    • CometAPI Account Balance Query API Usage Instructions
    • Claude Code Installation and Usage Guide
    • Gemini CLI Installation and Usage Guide
    • Codex Usage Guide
  • 💳 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#

This endpoint allows you to generate music clips with specific details. There are three modes which can be useful for different scenarios.

Modes#

inspiration: only require a topic, both lyrics and music style will be decided by AI.
custom: require lyrics, music style and song title to create your custom piece of music
song continuation: almost the same parameters as the cutom mode but a few more for locating your previous music clips and continue generation based on your instructions: "task_id", "continue_clip_id", "continue_at", "task"

Inspiration Mode#

gpt_description_prompt (string): The prompt for the music generation. It's basically a sentence or a few words what you want your song about.

Custom Mode#

prompt (string): The prompt for the music submission.
tags (string): Tags associated with the music submission.
mv (string): The version of the music submission.
title (string): The title of the music submission.

Song Continuation#

prompt (string): The prompt for the music submission.
tags (string): Tags associated with the music submission.
mv (string): The version of the music submission.
title (string): The title of the music submission.
task_id (string): Identifier for the task associated with the music submission.
continue_clip_id (string): Identifier for the clip to continue from.
continue_at (string): Position to continue from in the music submission.
negative_tags (string): Negative tags associated with the music submission.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Successful Response
application/json
Body

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 '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-10-13 02:35:04
Previous
Generate lyrics
Next
Upload clip
Built with