> ## 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.

# Train Voice Model

> Create a custom AI voice model by providing a training audio URL and basic profile information.



## OpenAPI

````yaml POST /v1/voice/train
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/train:
    post:
      tags:
        - Voice
      summary: Train Voice Model
      description: >-
        Create a custom AI voice model by providing a training audio URL and
        basic profile information.
      operationId: TrainVoice
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VoiceTrainRequest'
      responses:
        '200':
          description: Training 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:
    VoiceTrainRequest:
      type: object
      description: The voice training request payload.
      properties:
        name:
          type: string
          description: The display name of the trained model.
          example: My Custom Voice
        languageCode:
          type: string
          description: The language code of the training audio.
          example: en-US
        gender:
          type: string
          description: The target voice gender.
          example: female
        audioUrl:
          type: string
          description: The remote audio URL used for training.
          example: https://example.com/training_audio.wav
        imageUrl:
          type: string
          description: The remote avatar image URL.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'Bearer token (API key). Format: `Bearer {your_api_key}`'

````