API Doc-ElkAPI
  1. Suno
API Doc-ElkAPI
  • Quick Start
    • Quick Start
    • Must-read for beginners
    • ElkAPI Announcement
  • API Reference
    • Error status code description
    • OpenAI Format
      • Veo3-chat format
      • seedance
      • response
      • generate video
      • image
      • Image Editing (gpt-image-1)
      • embed
      • Realtime
      • Get model list
      • Response ID to obtain results
      • Hunyuan3D
    • Anthropic Format
      • Anthropic Claude
    • Midjourney Image Generation
      • Quick teaching-complete process in one go
      • Task Query
        • pagination query
        • Specify ID to obtain task
      • Submit Imagine task
      • Submit video task
      • Submit editing task
      • Submit Action Task
      • Submit Blend task
      • Submit Describe task
      • Submit Modal
    • Image Generation
      • ideogram(images)
        • Official documentation (updated in real time)
        • Generate 3.0 (illustrated in the text)
        • Reframe 3.0 (Refactoring)
        • Replace Background 3.0
        • Remix 3.0 (Mixed Graph)
        • Edit 3.0 (Edit)
        • Generate (text and image)
        • Remix (mixed image)
        • Upscale (enlarged high-definition)
        • Describe
        • Edit
      • Flux(images)
        • Create Task - General
        • generate image
        • Fine tuning (temporarily unavailable)
        • query task
        • Generate image (replica format)
      • Replicate(image)
        • Create Task - General
        • Create task - float kontext pro, max
        • Create task-black forest labs/flux-1.1-pro
        • Create task-black forest labs/flux-1.1-pro ultra
        • query task
        • Create task
      • Recraft(images)
        • Generate Image
        • Vectorize Image
        • Remove Background
        • Clarity Upscale
        • Create style
        • Generative Upscale
    • Music Generation
      • Suno
        • Set suno version
        • Suno API Scenario Application Guide
        • Generate lyrics
          POST
        • Generate music
          POST
        • Upload music
          POST
        • Song Splicing
          POST
        • Full track acoustic separation
          POST
        • Single track acoustic separation
          POST
        • Create a new Persona
          POST
        • Query a single task
          GET
        • Generate MP4 MV video
          GET
        • Retrieve WAV format files
          GET
        • Timing: Lyrics, audio timeline
          GET
        • Batch query task
          POST
        • Create music using persona_id
          POST
      • Udio (not available yet)
        • Generate music
        • Query a single task
    • Video Generation
      • veo3
        • veo3-chat format
        • Submit video generation task
        • Check the video generation status
      • Dream Test
        • seedance
      • runway(video)
        • Official format
          • Generate videos from images
          • Get detailed task information
        • Reverse format
          • Generate (text)
          • Generate (refer to image)
          • Video2video video to video style redrawing
          • Act one emoji transfer
          • Feed - Get Task
      • kling (video)
        • Callback Protocol
        • image expansion
        • generate image
        • text-to-video
        • image-to-video
        • Video extension
        • Virtual try on
        • lip-sync
        • video effects
        • Query task (single)
      • luma (video)
        • Official API format
          • generate video
          • Single query task
      • MiniMax Conch (video)
        • Official Documentation
        • video generation
        • query task
        • File Download
      • PIKA(video)
        • Universal version
          • generate video
          • Query video tasks
        • Generate (reference video/extended video)
        • Generate (refer to image)
        • Generate (text)
        • feed
      • sora
        • Reverse format
          • Create video
          • Generate Video
          • Query video tasks
    • Audio
      • Text to audio conversion
      • audio to text
      • Create translation
  • Integration Guide
    • Best Practices
      • Claude code access instructions
      • ElkAPI Account Balance Query API Usage Instructions
      • Retry logic documentation using ElkAPI and OpenAI's official API
      • Midjorney Calling Best Practices
      • Runway Call Best Practices
    • Application Integration Guide
  • Pricing and Billing
    • About Price
    • About Grouping
  • Help Center
    • Help Center
    • Interface stability
    • Common Misconceptions
    • Use confusion
    • Privacy Policy
    • Terms of Service
  1. Suno

Generate music

POST
https://api.elkapi.com/suno/submit/music

Generate Music Clips#

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

Modes#

Inspiration: Simply provide a theme; the lyrics and musical style will be determined by AI.
Custom: Requires lyrics, musical style, and song title to create your own custom music clip.
Song Continuation: The parameters are nearly identical to the Clip mode, but with additional parameters for locating the previous music clip and continuing the generation process based on your instructions: "task_id", "continue_clip_id", "continue_at", and "task".

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.elkapi.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. Custom 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. Continuation{"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", //Can be empty"tags": "bass-driven atmospheric heavy metal","negative_tags": "dance","mv": "chirp-v4", //Continue writing chip-v4-upload after uploading"title": "City Lights","task_id": "736a6f88-bd29-4b1e-b110-37132a5325ac","continue_clip_id": "736a6f88-bd29-4b1e-b110-37132a5325ac_1", //Fill in the ID with a serial number at the end, not clipuid"continue_at": 80,"task": "extend"}4. Use Persona_id to create music** * Precautions:***MV is chip-v3-5-tau or chip-v4-tau or chip-auk*The task is artist_comsistency*Persona_id is the return ID obtained from the steps of creating a new persona interface*Artisst_clip_id is the clipuid used in the music generation process{Prompt ":" [Verse] \ n You have been by my side from morning till dusk, always warm, not afraid of wind and rain, holding hands tightly and never parting. \ n \ n [Verse 2] \ n With you by my side, I am not alone, just like the stars at night. No matter how long the road is, it doesn'\''t feel far. Because you are my light. \ n \ n [Chorus] \ n Husband, I love you. \ n You are the only one in the world. No matter where you are, my heart follows me like a shadow. \ n \ n [Verse 3] \ n You are my safe haven. Every night, my dreams are yours. Even if the road ahead is hard, everything is beautiful with you. \ n \ n [Chorus] Husband, husband, I love you. You are the only one in the world. No matter where the ends of the earth are, your heart follows you like a shadow and never leaves. Bridge, every moment of your life, with you by your side, I will experience it. All tomorrow is better. 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"
}
Previous
Generate lyrics
Next
Upload music
Built with