API Doc-CometAPI
HomeDashBoardModel Marketplace
HomeDashBoardModel Marketplace
Discord_Support
  1. Suno
  • šŸš€ Get Start
    • Quick Start
    • Important Guidelines
    • Release Notes
  • šŸ’¬ Text Models-OpenAI Format
    • Anthropic Compatiable
      • Anthropic Claude
    • Chat
      POST
    • response
      POST
    • gpt-4o-image generates image
      POST
    • Images
      POST
    • Image Editing (gpt-image-1)
      POST
    • Recognizing Images
      POST
    • Embeddings
      POST
    • Realtime
      POST
    • Models
      GET
    • Hunyuan3D
      POST
  • šŸ–¼ļø 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
    • Flux(images)
      • Generate image (replicate format)
      • Create Task - General
      • flux fine-tune images(Temporarily unavailable)
      • flux generate image(Temporarily unavailable)
      • flux query
    • seededit/seedream
      • bytedance-image-generation(seedream)
      • bytedance-Image Editing (seededit)
    • Replicate(image)
      • Create Task - General
      • Create Task -flux-kontext-pro态max
      • Create Task -flux-1.1-pro
      • Create Task -flux-1.1-pro-ultra
      • replicate query
    • Recraft(Temporarily removed)
      • Appendix
      • Recraft Generate Image
      • Recraft Vectorize Image
      • Recraft Remove Background
      • Recraft Clarity Upscale
      • Recraft Create style
      • Recraft Generative Upscale
    • Ideogram(Temporarily removed)
      • 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))
    • Gemini
      • Guide to calling gemini-2.5-flash-image
      • Gemini generates image
      • Gemini text dialog
  • šŸŽµ 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
      • 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
    • 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
    • sora(temporarily dismantle)
      • Reverse Format
        • Create Video
        • Query Video Task
        • Create Video
  • šŸ”Š 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"
}
Previous
Generate lyrics
Next
Upload clip
Built with