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

Create music using persona_id

Testing
POST
https://api.elkapi.com/suno/generate
Note that mv is chirp-v3-5-tau, chirp-v4-tau, or chirp-auk.
task is artist_consistency.
persona_id is the one obtained in the Create Personal step.
artist_clip_id is the clip_id from the Create Personal step.

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/generate' \
--header 'Authorization: Bearer {{api-key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "prompt": "[Verse]You go from dawn to duskAlways warm by my sideNot afraid of wind and rainHold hands tightly and never separate[Verse 2]With you by my side, I am not aloneLike stars in the nightNo matter how long the road is, it doesn'\''t feel too farBecause you are my light[Chorus]I Love My Husband You are the only one in the worldNo matter in the ends of the earthHeart follows like a shadow and never leaves[Verse 3]You are my safe havenEvery night in my dreams, it'\''s youEven though the road ahead may be toughWith you, everything is so beautiful[Chorus]I Love My Husband You are the only one in the worldNo matter in the ends of the earthHeart follows like a shadow and never leaves[Bridge]Every moment in lifeWith your company to experience itEverything will be better tomorrowBecause of you, I am invincible",
  "generation_type": "TEXT",
  "tags": "electronic, pop",
  "negative_tags": "",
  "mv": "chirp-v4-tau",
  "title": "husband",
  "task": "artist_consistency",
  "persona_id": "6a40ce76-2fbe-4272-8ccb-568ed0be7eda",
  "artist_clip_id": "117decaa-d0d1-4847-bcb0-9042086c433c"
}'
Response Response Example
{
  "id": "2d453a5f-c539-4fe0-9a66-24058c5dfb6a",
  "clips": [
    {
      "id": "0e6937df-64d8-41f9-82c6-b6dadc4426a8",
      "video_url": "",
      "audio_url": "",
      "major_model_version": "v4",
      "model_name": "chirp-v4",
      "metadata": {
        "tags": "electronic, pop",
        "prompt": "[Verse]You go from dawn to duskAlways warm by my sideNot afraid of wind and rainHold hands tightly and never separate[Verse 2]With you by my side, I am not aloneLike stars in the nightNo matter how long the road is, it doesn't feel too farBecause you are my light[Chorus]I Love My Husband You are the only one in the worldNo matter in the ends of the earthHeart follows like a shadow and never leaves[Verse 3]You are my safe havenEvery night in my dreams, it's youEven though the road ahead may be toughWith you, everything is so beautiful[Chorus]I Love My Husband You are the only one in the worldNo matter in the ends of the earthHeart follows like a shadow and never leaves[Bridge]Every moment in lifeWith your company to experience itEverything will be better tomorrowBecause of you, I am invincible",
        "type": "gen",
        "stream": true,
        "has_vocal": false,
        "artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163",
        "persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
        "task": "artist_consistency"
      },
      "is_liked": false,
      "user_id": "a3da04d5-0442-4bd3-b837-4c73ff600914",
      "display_name": "TwinklingVenue1595",
      "handle": "twinklingvenue1595",
      "is_handle_updated": false,
      "avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
      "is_trashed": false,
      "created_at": "2024-12-23T10:37:43.596Z",
      "status": "submitted",
      "title": "husband",
      "play_count": 0,
      "upvote_count": 0,
      "is_public": false
    },
    {
      "id": "fff58de4-7ccc-4b95-937b-3b66ec07cc65",
      "video_url": "",
      "audio_url": "",
      "major_model_version": "v4",
      "model_name": "chirp-v4",
      "metadata": {
        "tags": "electronic, pop",
        "prompt": "[Verse]You go from dawn to duskAlways warm by my sideNot afraid of wind and rainHold hands tightly and never separate[Verse 2]With you by my side, I am not aloneLike stars in the nightNo matter how long the road is, it doesn't feel too farBecause you are my light[Chorus]I Love My Husband You are the only one in the worldNo matter in the ends of the earthHeart follows like a shadow and never leaves[Verse 3]You are my safe havenEvery night in my dreams, it's youEven though the road ahead may be toughWith you, everything is so beautiful[Chorus]I Love My Husband You are the only one in the worldNo matter in the ends of the earthHeart follows like a shadow and never leaves[Bridge]Every moment in lifeWith your company to experience itEverything will be better tomorrowBecause of you, I am invincible",
        "type": "gen",
        "stream": true,
        "has_vocal": false,
        "artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163",
        "persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
        "task": "artist_consistency"
      },
      "is_liked": false,
      "user_id": "a3da04d5-0442-4bd3-b837-4c73ff600914",
      "display_name": "TwinklingVenue1595",
      "handle": "twinklingvenue1595",
      "is_handle_updated": false,
      "avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
      "is_trashed": false,
      "created_at": "2024-12-23T10:37:43.596Z",
      "status": "submitted",
      "title": "husband",
      "play_count": 0,
      "upvote_count": 0,
      "is_public": false
    }
  ],
  "metadata": {
    "tags": "electronic, pop",
    "prompt": "[Verse]You go from dawn to duskAlways warm by my sideNot afraid of wind and rainHold hands tightly and never separate[Verse 2]With you by my side, I am not aloneLike stars in the nightNo matter how long the road is, it doesn't feel too farBecause you are my light[Chorus]I Love My Husband You are the only one in the worldNo matter in the ends of the earthHeart follows like a shadow and never leaves[Verse 3]You are my safe havenEvery night in my dreams, it's youEven though the road ahead may be toughWith you, everything is so beautiful[Chorus]I Love My Husband You are the only one in the worldNo matter in the ends of the earthHeart follows like a shadow and never leaves[Bridge]Every moment in lifeWith your company to experience itEverything will be better tomorrowBecause of you, I am invincible",
    "type": "gen",
    "stream": true,
    "has_vocal": false,
    "artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163",
    "persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
    "task": "artist_consistency"
  },
  "major_model_version": "v4",
  "status": "complete",
  "created_at": "2024-12-23T10:37:43.581Z",
  "batch_size": 1
}
Previous
Batch query task
Next
Generate music
Built with