Generate Persona

Create a personalized music Persona based on generated music, giving the music a unique identity and characteristics.

Usage Guide

Use this endpoint to create Personas (music characters) for generated music
Requires the taskId from music generation related endpoints (generate, extend, cover, upload-extend) and audio ID
Customize the Persona name and description to give music unique personality
Generated Personas can be used for subsequent music creation and style transfer

Parameter Details

taskId: Required parameter, can be obtained from the following endpoints:
- Generate Music (/api/v1/generate)
- Extend Music (/api/v1/generate/extend)
- Upload And Cover Audio (/api/v1/generate/upload-cover)
- Upload And Extend Audio (/api/v1/generate/upload-extend)
audioId: Required parameter, specifies the audio ID to create Persona for
name: Required parameter, assigns an easily recognizable name to the Persona
description: Required parameter, describes the Persona’s musical characteristics, style, and personality

Developer Notes

Important: Ensure the music generation task is fully completed before calling this endpoint. If the music is still generating, this endpoint will return a failure
Model Requirement: Persona generation only supports taskId from music generated with models above v3_5 (v3_5 itself is not supported)
It is recommended to provide detailed descriptions for Personas to better capture musical characteristics
The returned personaId can be used in subsequent music generation requests to create music with similar style characteristics
You can apply the personaId to the following endpoints:
Each audio ID can only generate a Persona once

Parameter Example

{
  "taskId": "5c79****be8e",
  "audioId": "e231****-****-****-****-****8cadc7dc",
  "name": "Electronic Pop Singer",
  "description": "A modern electronic music style pop singer, skilled in dynamic rhythms and synthesizer tones"
}

Ensure that the music generation task corresponding to the taskId is complete and the audioId is within the valid range.

Providing detailed and specific descriptions for Personas helps the system more accurately capture musical style characteristics.

Rate limits and quotas are enforced by Apikley and may differ from upstream providers.

OpenAPI

suno-api/suno-api.json post /api/v1/generate/generate-persona

openapi: 3.0.0
info:
  title: Suno API
  description: Apikley Suno API Documentation
  version: 1.0.0
  contact:
    name: Technical Support
    email: support@apikley.ru
servers:
  - url: https://api.apikley.ru
    description: API Server
security:
  - BearerAuth: []
paths:
  /api/v1/generate/generate-persona:
    post:
      summary: Generate Persona
      description: >-
        Create a personalized music Persona based on generated music, giving the
        music a unique identity and characteristics.


        ### Usage Guide

        - Use this endpoint to create Personas (music characters) for generated
        music

        - Requires the taskId from music generation related endpoints (generate,
        extend, cover, upload-extend) and audio ID

        - Customize the Persona name and description to give music unique
        personality

        - Generated Personas can be used for subsequent music creation and style
        transfer


        ### Parameter Details

        - `taskId`: Required parameter, can be obtained from the following
        endpoints:
          - Generate Music (/api/v1/generate)
          - Extend Music (/api/v1/generate/extend)
          - Upload And Cover Audio (/api/v1/generate/upload-cover)
          - Upload And Extend Audio (/api/v1/generate/upload-extend)
        - `audioId`: Required parameter, specifies the audio ID to create
        Persona for

        - `name`: Required parameter, assigns an easily recognizable name to the
        Persona

        - `description`: Required parameter, describes the musical
        characteristics, style, and personality of the Persona


        ### Developer Notes

        - **Important**: Ensure the music generation task is fully completed
        before calling this endpoint. If the music is still generating, this
        endpoint will return a failure

        - **Model Requirement**: Persona generation only supports taskId from
        music generated with models above v3_5 (v3_5 itself is not supported)

        - Recommend providing detailed descriptions for Personas to better
        capture musical characteristics

        - The returned `personaId` can be used in subsequent music generation
        requests to create music with similar style characteristics

        - You can apply the `personaId` to the following endpoints: Generate
        Music, Extend Music, Upload And Cover Audio, Upload And Extend Audio

        - Each audio ID can only generate one Persona
      operationId: generate-persona
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - taskId
                - audioId
                - name
                - description
              properties:
                taskId:
                  type: string
                  description: >-
                    Unique identifier of the original music generation task.
                    This can be a taskId returned from any of the following
                    endpoints:

                    - Generate Music (/api/v1/generate)

                    - Extend Music (/api/v1/generate/extend)

                    - Upload And Cover Audio (/api/v1/generate/upload-cover)

                    - Upload And Extend Audio (/api/v1/generate/upload-extend)
                  example: 5c79****be8e
                audioId:
                  type: string
                  description: >-
                    Unique identifier of the audio track to create Persona for.
                    This ID is returned in the callback data after music
                    generation completes.
                  example: e231****-****-****-****-****8cadc7dc
                name:
                  type: string
                  description: >-
                    Name for the Persona. A descriptive name that captures the
                    essence of the musical style or character.
                  example: Electronic Pop Singer
                description:
                  type: string
                  description: >-
                    Detailed description of the Persona's musical
                    characteristics, style, and personality. Be specific about
                    genre, mood, instrumentation, and vocal qualities.
                  example: >-
                    A modern electronic music style pop singer, skilled in
                    dynamic rhythms and synthesizer tones
      responses:
        '200':
          description: Request successful
          content:
            application/json:
              schema:
                allOf:
                  - type: object
                    properties:
                      code:
                        type: integer
                        enum:
                          - 200
                          - 401
                          - 402
                          - 404
                          - 409
                          - 422
                          - 429
                          - 451
                          - 455
                          - 500
                        description: >-
                          Response Status Codes


                          - **200**: Success - Request has been processed
                          successfully  

                          - **401**: Unauthorized - Authentication credentials
                          are missing or invalid  

                          - **402**: Insufficient Credits - Account does not
                          have enough credits to perform the operation  

                          - **404**: Not Found - The requested resource or
                          endpoint does not exist  

                          - **409**: Conflict - Persona already exists for this
                          music

                          - **422**: Validation Error - The request parameters
                          failed validation checks  

                          - **429**: Rate Limited - Request limit has been
                          exceeded for this resource  

                          - **451**: Unauthorized - Failed to fetch the music
                          data. Kindly verify any access limits set by you or
                          your service provider  

                          - **455**: Service Unavailable - System is currently
                          undergoing maintenance  

                          - **500**: Server Error - An unexpected error occurred
                          while processing the request
                      msg:
                        type: string
                        description: Error message when code != 200
                        example: success
                  - type: object
                    properties:
                      data:
                        type: object
                        properties:
                          personaId:
                            type: string
                            description: >-
                              Unique identifier for the generated Persona. This
                              personaId can be used in subsequent music
                              generation requests (Generate Music, Extend Music,
                              Upload And Cover Audio, Upload And Extend Audio)
                              to create music with similar style
                              characteristics.
                            example: a1b2****c3d4
                          name:
                            type: string
                            description: Name of the Persona as provided in the request.
                            example: Electronic Pop Singer
                          description:
                            type: string
                            description: >-
                              Description of the Persona's musical
                              characteristics, style, and personality as
                              provided in the request.
                            example: >-
                              A modern electronic music style pop singer,
                              skilled in dynamic rhythms and synthesizer tones
        '500':
          $ref: '#/components/responses/Error'
components:
  responses:
    Error:
      description: Server Error
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        All APIs require authentication via Bearer Token.


        Get API Key:

        1. Visit [API Key Management Page](https://app.apikley.ru/keys) to get your
        API Key


        Usage:

        Add to request header:

        Authorization: Bearer APIKLEY_API_KEY


        Note:

        - Keep your API Key secure and do not share it with others

        - If you suspect your API Key has been compromised, reset it immediately
        in the management page

To find navigation and other pages in this documentation, fetch the llms.txt file at: https://docs.apikley.ru/llms.txt

Getting Started

Veo3 API

Suno API

Runway API

Image Models

Video Models

Audio Models

Luma API

Flux Kontext API

4o Image API

File Upload API

Common API

Suno api generate persona

Generate Persona

Usage Guide

Parameter Details

Developer Notes

Parameter Example

OpenAPI

​Generate Persona

​Usage Guide

​Parameter Details

​Developer Notes

​Parameter Example

​OpenAPI

Generate Persona

Usage Guide

Parameter Details

Developer Notes

Parameter Example

OpenAPI