API Doc-CometAPI
HomeDashBoardModel Marketplace
HomeDashBoardModel Marketplace
Discord_Support
  1. Suno
  • GET START
    • Quick Start
    • Important Guidelines
    • Release Notes
  • API Reference
    • Error Codes & Handling
    • Text Models-openai format
      • Chat
      • response
      • gpt-4o-image generates image
      • Images
      • Image Editing (gpt-image-1)
      • Recognizing Images
      • Embeddings
      • Realtime
      • Models
      • Hunyuan3D
    • Anthropic Compatiable
      • Anthropic Claude
    • Image Models
      • 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)
      • Flux(images)
        • Generate image (replicate format)
        • Create Task - General
        • flux fine-tune images(Temporarily unavailable)
        • flux generate image(Temporarily unavailable)
        • flux query
      • 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(images)
        • Appendix
        • Recraft Generate Image
        • Recraft Vectorize Image
        • Recraft Remove Background
        • Recraft Clarity Upscale
        • Recraft Create style
        • Recraft Generative Upscale
      • Ideogram(images)(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))
    • 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
          • 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
        • testing
          • Multimodal Video Editing (In Testing)
            • Initialize Video for Editing
            • Add Video Selection
            • Delete Video Selection
            • Clear Video Selection
            • Preview Selected Video Area
            • Create Task
        • Expanded
        • Generating images
        • Text Generation Video
        • Image Generation Video
        • Multi-Image To Video
        • Multi-Image to Image
        • Video Extension
        • virtual try-on
        • lip sync
        • effects
        • Individual queries
        • Video to Sound Effect
        • Text to Sound Effect
      • 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
      • bytedance
        • bytedance-video
        • bytedance-video get
        • bytedance-image-generation
        • bytedance-Image Editing
      • PIKA(video)
        • 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
  • CODE EXAMPLES
    • Code example
  • Guides & Tutorials
    • Integration Guides
      • 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
    • Best Practices
      • Claude Code Installation and Usage Guide
      • Gemini CLI Installation and Usage Guide
      • CometAPI Account Balance Query API Usage Instructions
      • Retry Logic Documentation for CometAPI and OpenAI Official API
      • Midjourney Best Practices
      • Runway Best Practices
  • Pricing & Billing
    • About Pricing
  • Support
    • Help Center
    • Confusion about use
    • Common Misconceptions
    • Terms of service
    • Privacy policy
    • Interface Stability
  • Schemas
    • Schemas
      • Sample Schemas
        • Pet
        • Category
        • Tag
      • VideoGenerationRequest
      • TextGenerateRequest
      • ImageGenerateRequest
      • VideoGenerateRequest
      • BaseResponse
      • TextToImageRequest
      • Two-person interactive effect
      • VideoGenerationResponse
      • GenerateResponse
      • EditImageRequest
      • Single image effect
      • ErrorResponse
      • BlendImagesRequest
      • UpscaleRequest
      • DescribeImageRequest
      • ImageGenerationResponse
      • ImageDescriptionResponse
      • ErrorResponse
    • chat-output
    • chat-input
  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 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"
}'
Response Response Example
{
    "code": "success",
    "message": "",
    "data": "736a6f88-bd29-4b1e-b110-37132a5325ac"
}

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Successful Response
application/json
Body

Previous
Generate lyrics
Next
Upload clip
Built with