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

# Voice Design

> Design a new AI voice from a text prompt and preview it with sample text.



## OpenAPI

````yaml POST /v1/voice/design
openapi: 3.0.1
info:
  title: FineVoice API
  description: >-
    This is the documentation for the FineVoice API. If you have any questions
    or need assistance, please contact support@finevoice.ai.
  version: v1
servers:
  - url: https://apis.finevoice.ai
    description: FineVoice API Gateway
security:
  - BearerAuth: []
paths:
  /v1/voice/design:
    post:
      tags:
        - Voice
      summary: Voice Design
      description: >-
        Design a new AI voice from a text prompt and preview it with sample
        text.
      operationId: VoiceDesign
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VoiceDesignRequest'
      responses:
        '200':
          description: Voice design task accepted.
          content:
            application/json:
              schema:
                type: object
        '401':
          description: Unauthorized — invalid or missing API key.
        '422':
          description: Validation error — check request body fields.
components:
  schemas:
    VoiceDesignRequest:
      type: object
      description: The voice design request payload.
      properties:
        taskId:
          type: string
          description: Task identifier for updating an existing design task.
        engine:
          type: string
          description: 'Voice generation engine. Supported: `v1`, `v2`.'
          example: v2
        prompt:
          type: string
          description: Voice design prompt describing desired voice characteristics.
          example: A warm, friendly female voice with a slight British accent
        previewText:
          type: string
          description: Preview text used to audition the designed voice.
          example: Hello, this is a preview of the designed voice.
        modelId:
          type: string
          description: The base model identifier.
        seed:
          type: integer
          format: int64
          description: Random seed for deterministic generation.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'Bearer token (API key). Format: `Bearer {your_api_key}`'

````