> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beyondwords.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Design voice previews

> Generate voice preview audio from a text description

Generate voice preview audio from a text description. Use this as the first step in [voice generation](/docs-and-guides/voices/voice-generation).

After choosing a preview, call [Finalize voice design](/api-reference/voices/finalize-design) to save the voice.


## OpenAPI

````yaml post /organization/voices/design_previews
openapi: 3.0.1
info:
  title: BeyondWords REST API
  description: |-
    This is the documentation for the BeyondWords REST API.
              You can use this API to use BeyondWords programmatically.
              You can get your API Key and Project ID for each project in the Project settings tab in the BeyondWords
              <a href="https://dash.beyondwords.io/dashboard">dashboard</a>.
  version: 1.0.0
servers:
  - url: https://api.beyondwords.io/v1
security: []
paths:
  /organization/voices/design_previews:
    post:
      tags:
        - Voices
      summary: Design voice previews
      description: Generate voice preview audio from a text description
      operationId: organization/voices#design_previews
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/requestBodyVoiceDesignPreviews'
            examples:
              example:
                $ref: '#/components/examples/requestBodyVoiceDesignPreviewsExample'
      responses:
        '200':
          description: OK
          content:
            application/json:
              examples:
                example:
                  $ref: '#/components/examples/voiceDesignPreviewsExample'
              schema:
                $ref: '#/components/schemas/voiceDesignPreviewsModel'
        '401':
          description: Invalid authentication token
          content:
            application/json:
              examples:
                example:
                  $ref: '#/components/examples/unauthorizedErrorExample'
              schema:
                $ref: '#/components/schemas/errorModel'
      security:
        - apiKey: []
components:
  schemas:
    requestBodyVoiceDesignPreviews:
      type: object
      required:
        - voice_description
      properties:
        voice_description:
          type: string
          description: A text description of the desired voice characteristics
          minLength: 20
        text:
          type: string
          description: >-
            Optional preview text (100–1000 characters). If omitted, ElevenLabs
            auto-generates it.
          minLength: 100
          maxLength: 1000
    voiceDesignPreviewsModel:
      type: object
      properties:
        text:
          type: string
          description: >-
            The text used to generate the previews (auto-generated or
            client-supplied)
        previews:
          type: array
          items:
            type: object
            properties:
              generated_voice_id:
                type: string
                description: >-
                  Identifier for the generated voice preview, used to create a
                  final voice
              audio_base_64:
                type: string
                description: Base64-encoded audio of the preview
              duration_secs:
                type: number
                description: Duration of the preview audio in seconds
              language:
                type: string
                description: Language code of the preview
    errorModel:
      type: object
      properties:
        code:
          type: integer
          description: Error code
        message:
          type: string
          description: Error message
        errors:
          type: array
          nullable: true
          items:
            type: object
            properties:
              location:
                type: string
              message:
                type: string
  examples:
    requestBodyVoiceDesignPreviewsExample:
      summary: Sample design voice previews request body
      value:
        voice_description: >-
          A warm, articulate British female news presenter with a calm,
          authoritative tone and clear pronunciation
    voiceDesignPreviewsExample:
      summary: A sample voice design previews response
      value:
        text: >-
          Good evening. Here is the latest update from London. Markets have
          responded positively to today's economic data.
        previews:
          - generated_voice_id: gen_british_female_01
            audio_base_64: SUQzBAAAAAAAI1RTU0UAAAAPAAADTGF2ZjU4LjMyLjEwMAAAAAAAAAAAAAAA
            duration_secs: 9.4
            language: en
          - generated_voice_id: gen_british_female_02
            audio_base_64: SUQzBAAAAAAAI1RTU0UAAAAPAAADTGF2ZjU4LjMyLjEwMAAAAAAAABBBBBBBB
            duration_secs: 8.9
            language: en
    unauthorizedErrorExample:
      summary: Unauthorized error
      value:
        code: 401
        message: Unauthorized
  securitySchemes:
    apiKey:
      type: apiKey
      name: X-Api-Key
      in: header

````