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 a new Persona

POST
https://api.elkapi.com/suno/persona/create

🎡 Generate Persona: Singer Style Process 🎡#

πŸš€ Operation Steps:#

1.
Step 1. Generate music using any of the "Generate Music Scenes" steps 1, 2, or 3. Version 4.5 must be used. Obtain the task id.
2.
Step 2. After obtaining the task id, retrieve the corresponding clip_id value for the song as needed.
3.
Step 3. Enter the corresponding clip_id as a parameter and enter it into the API. The returned id is the persona_id for use in the next step.
Using the API: Use persona_id to create Notes:**
mv is chirp-v3-5-tau, chirp-v4-tau, or chirp-auk
task is artist_consistency
persona_id is the id returned from the Create Persona API step
artist_clip_id is the clip_id from the Generate Music 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/persona/create' \
--header 'Authorization: Bearer {{api-key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "root_clip_id": "82294225-6537-4dfc-adcd-be3b5edaa46c",
  "name": "Persona Title",
  "description": "Persona description",
  "clips": [
    "54834687-5e79-4f08-8e14-cf188f15b598"
  ],
  "is_public": true
}'
Response Response Example
{
    "id": "6a40ce76-2fbe-4272-8ccb-568ed0be7eda",
    "name": "string",
    "description": "string",
    "image_s3_id": "string",
    "root_clip_id": "string",
    "clip": {
        "id": "string",
        "entity_type": "string",
        "video_url": "string",
        "audio_url": "string",
        "image_url": "string",
        "image_large_url": "string",
        "major_model_version": "string",
        "model_name": "string",
        "metadata": {
            "tags": "string",
            "prompt": "string",
            "type": "string",
            "duration": 0,
            "refund_credits": true,
            "stream": true,
            "can_remix": true,
            "is_remix": true,
            "priority": 0
        },
        "is_liked": true,
        "user_id": "string",
        "display_name": "string",
        "handle": "string",
        "is_handle_updated": true,
        "avatar_image_url": "string",
        "is_trashed": true,
        "flag_count": 0,
        "display_tags": "string",
        "created_at": "string",
        "status": "string",
        "title": "string",
        "play_count": 0,
        "upvote_count": 0,
        "is_public": true,
        "allow_comments": true
    },
    "user_display_name": "string",
    "user_handle": "string",
    "user_image_url": "string",
    "persona_clips": [
        {
            "clip": {
                "id": "string",
                "entity_type": "string",
                "video_url": "string",
                "audio_url": "string",
                "image_url": "string",
                "image_large_url": "string",
                "major_model_version": "string",
                "model_name": "string",
                "metadata": {
                    "tags": "string",
                    "prompt": "string",
                    "type": "string",
                    "duration": 0,
                    "refund_credits": true,
                    "stream": true,
                    "can_remix": true,
                    "is_remix": true,
                    "priority": 0
                },
                "is_liked": true,
                "user_id": "string",
                "display_name": "string",
                "handle": "string",
                "is_handle_updated": true,
                "avatar_image_url": "string",
                "is_trashed": true,
                "flag_count": 0,
                "display_tags": "string",
                "created_at": "string",
                "status": "string",
                "title": "string",
                "play_count": 0,
                "upvote_count": 0,
                "is_public": true,
                "allow_comments": true
            },
            "id": 0
        }
    ],
    "is_suno_persona": true,
    "is_trashed": true,
    "is_owned": true,
    "is_public": true,
    "is_public_approved": true,
    "is_loved": true,
    "upvote_count": 0,
    "clip_count": 0
}
Previous
Single track acoustic separation
Next
Query a single task
Built with