openapi: 3.0.0
info:
  title: Elevenlabs API
  description: Apikley Elevenlabs API Documentation - undefined
  version: 1.0.0
  contact:
    name: Technical Support
    email: [email protected]
servers:
  - url: https://api.apikley.ru
    description: API Server
security:
  - BearerAuth: []
paths:
  /api/v1/jobs/createTask:
    post:
      summary: Generate content using elevenlabs/text-to-speech-turbo-2-5
      operationId: elevenlabs-text-to-speech-turbo-2-5
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model
              properties:
                model:
                  type: string
                  enum:
                    - elevenlabs/text-to-speech-turbo-2-5
                  default: elevenlabs/text-to-speech-turbo-2-5
                  description: >-
                    The model name to use for generation. Required field.


                    - Must be `elevenlabs/text-to-speech-turbo-2-5` for this
                    endpoint
                  example: elevenlabs/text-to-speech-turbo-2-5
                callBackUrl:
                  type: string
                  format: uri
                  description: >-
                    The URL to receive generation task completion updates.
                    Optional but recommended for production use.


                    - System will POST task status and results to this URL when
                    generation completes

                    - Callback includes generated content URLs and task
                    information

                    - Your callback endpoint should accept POST requests with
                    JSON payload containing results

                    - Alternatively, use the Get Task Details endpoint to poll
                    task status
                  example: https://your-domain.com/api/callback
                input:
                  type: object
                  description: Input parameters for the generation task
                  properties:
                    text:
                      description: >-
                        The text to convert to speech (Max length: 5000
                        characters)
                      type: string
                      maxLength: 5000
                      example: >-
                        Unlock powerful API with Apikley! Affordable, scalable
                        APl integration, free trial playground, and secure,
                        reliable performance.
                    voice:
                      description: The voice to use for speech generation
                      type: string
                      enum:
                        - Rachel
                        - Aria
                        - Roger
                        - Sarah
                        - Laura
                        - Charlie
                        - George
                        - Callum
                        - River
                        - Liam
                        - Charlotte
                        - Alice
                        - Matilda
                        - Will
                        - Jessica
                        - Eric
                        - Chris
                        - Brian
                        - Daniel
                        - Lily
                        - Bill
                      default: Rachel
                      example: Rachel
                    stability:
                      description: >-
                        Voice stability (0-1) (Min: 0, Max: 1, Step: 0.01)
                        (step: 0.01)
                      type: number
                      minimum: 0
                      maximum: 1
                      default: 0.5
                      example: 0.5
                    similarity_boost:
                      description: >-
                        Similarity boost (0-1) (Min: 0, Max: 1, Step: 0.01)
                        (step: 0.01)
                      type: number
                      minimum: 0
                      maximum: 1
                      default: 0.75
                      example: 0.75
                    style:
                      description: >-
                        Style exaggeration (0-1) (Min: 0, Max: 1, Step: 0.01)
                        (step: 0.01)
                      type: number
                      minimum: 0
                      maximum: 1
                      default: 0
                      example: 0
                    speed:
                      description: >-
                        Speech speed (0.7-1.2). Values below 1.0 slow down the
                        speech, above 1.0 speed it up. Extreme values may affect
                        quality. (Min: 0.7, Max: 1.2, Step: 0.01) (step: 0.01)
                      type: number
                      minimum: 0.7
                      maximum: 1.2
                      default: 1
                      example: 1
                    timestamps:
                      description: >-
                        Whether to return timestamps for each word in the
                        generated speech (Boolean value (true/false))
                      type: boolean
                      example: false
                    previous_text:
                      description: >-
                        The text that came before the text of the current
                        request. Can be used to improve the speech's continuity
                        when concatenating together multiple generations or to
                        influence the speech's continuity in the current
                        generation. (Max length: 5000 characters)
                      type: string
                      maxLength: 5000
                      example: ''
                    next_text:
                      description: >-
                        The text that comes after the text of the current
                        request. Can be used to improve the speech's continuity
                        when concatenating together multiple generations or to
                        influence the speech's continuity in the current
                        generation. (Max length: 5000 characters)
                      type: string
                      maxLength: 5000
                      example: ''
                    language_code:
                      description: >-
                        Language code (ISO 639-1) used to enforce a language for
                        the model. Currently only Turbo v2.5 and Flash v2.5
                        support language enforcement. For other models, an error
                        will be returned if language code is provided. (Max
                        length: 500 characters)
                      type: string
                      maxLength: 500
                      example: ''
                  required:
                    - text
            example:
              model: elevenlabs/text-to-speech-turbo-2-5
              callBackUrl: https://your-domain.com/api/callback
              input:
                text: >-
                  Unlock powerful API with Apikley! Affordable, scalable APl
                  integration, free trial playground, and secure, reliable
                  performance.
                voice: Rachel
                stability: 0.5
                similarity_boost: 0.75
                style: 0
                speed: 1
                timestamps: false
                previous_text: ''
                next_text: ''
                language_code: ''
      responses:
        '200':
          description: Request successful
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ApiResponse'
                  - type: object
                    properties:
                      data:
                        type: object
                        properties:
                          taskId:
                            type: string
                            description: >-
                              Task ID, can be used with Get Task Details
                              endpoint to query task status
                            example: task_elevenlabs_1765185518880
                          recordId:
                            type: string
                            description: Record ID, can be used to get the record details
                            example: elevenlabs_1765185518880
              example:
                code: 200
                msg: success
                data:
                  taskId: task_elevenlabs_1765185518880
                  recordId: elevenlabs_1765185518880
        '500':
          $ref: '#/components/responses/Error'
components:
  schemas:
    ApiResponse:
      type: object
      properties:
        code:
          type: integer
          enum:
            - 200
            - 401
            - 402
            - 404
            - 422
            - 429
            - 455
            - 500
            - 501
            - 505
          description: >-
            Response status code


            - **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

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

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

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

            - **500**: Server Error - An unexpected error occurred while
            processing the request

            - **501**: Generation Failed - Content generation task failed

            - **505**: Feature Disabled - The requested feature is currently
            disabled
        msg:
          type: string
          description: Response message, error description when failed
          example: success
  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