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

# Get Voice Details

> Get detailed information of a specific voice



## OpenAPI

````yaml /api-reference/openapi.yaml get /v1/voices/{voice_id}
openapi: 3.0.0
info:
  title: VoxNexus API
  version: 1.0.0
  description: VoxNexus API Documentation
  contact:
    name: API Support
    url: https://voxnexus.ai/support
    email: support@voxnexus.ai
servers:
  - url: https://api.voxnexus.ai
security: []
paths:
  /v1/voices/{voice_id}:
    get:
      tags:
        - voices
      summary: Get Voice Details
      description: Get detailed information of a specific voice
      operationId: getVoice
      parameters:
        - name: voice_id
          in: path
          description: |
            Voice unique identifier
          required: true
          schema:
            type: string
            example: vn-xiaoxiao
      responses:
        '200':
          description: Successfully returns voice details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Voice'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    Voice:
      type: object
      properties:
        voice_id:
          type: string
          description: Voice unique identifier
          example: vn-xiaoxiao
        name:
          type: string
          description: Voice name
          example: Xiaoxiao
        display_name:
          type: string
          description: Display name (localized)
          example: Xiaoxiao
        gender:
          type: string
          description: Gender
          enum:
            - male
            - female
            - neutral
          example: female
        category:
          type: string
          description: Voice category
          enum:
            - premade
            - cloned
            - generated
          example: premade
        description:
          type: string
          description: Voice description
          example: A warm and friendly female voice, suitable for general scenarios
        primary_locale:
          type: string
          description: Primary locale code
          example: zh-CN
        is_multilingual:
          type: boolean
          description: Whether the voice supports multiple languages
          example: true
        supported_locales:
          type: array
          description: List of supported locales with details
          items:
            type: object
            properties:
              locale:
                type: string
                description: Locale code (e.g., en-US, zh-CN)
                example: zh-CN
              language:
                type: string
                description: Language code (ISO 639-1)
                example: zh
              locale_name:
                type: string
                description: Human-readable locale name
                example: Chinese (Simplified, China)
              accent:
                type: string
                description: Accent for this locale
                example: mandarin
              preview_url:
                type: string
                description: Preview audio URL for this locale
                example: https://api.voxnexus.ai/samples/vn-xiaoxiao/zh-CN.mp3
              is_primary:
                type: boolean
                description: Whether this is the primary locale
                example: true
            required:
              - locale
              - language
        labels:
          type: object
          description: Display labels (personalities, scenarios, etc.)
          additionalProperties: true
          example:
            personalities:
              - warm
              - friendly
            scenarios:
              - assistant
              - news
        preview_url:
          type: string
          description: Default sample audio URL
          example: https://api.voxnexus.ai/samples/vn-xiaoxiao.mp3
        config_schema:
          type: object
          description: >-
            Supported voice_config keys — a flat map from key to its definition
            (type/description/enum). Omitted when the voice has no configurable
            keys
          additionalProperties: true
          example:
            style:
              type: string
              description: Speaking style
              enum:
                - cheerful
                - sad
        models:
          type: array
          description: List of supported model IDs for this voice
          items:
            type: string
          example:
            - vn-tts-basic
            - vn-tts-ultra
      required:
        - voice_id
        - name
        - gender
        - primary_locale
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Error message
          example: Invalid request parameters
        code:
          type: string
          description: Error code
          example: INVALID_REQUEST
        details:
          type: string
          description: Detailed error information (optional)
          example: Detailed error information
        request_id:
          type: string
          description: Request ID (optional)
          example: req_1234567890
      required:
        - error
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
      description: Authenticate using X-Api-Key header

````