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

# List Realtime Options

> Retrieve a comprehensive list of all supported realtime voice providers, their available models, supported languages, voice configurations, and required environment variables.

Retrieve the complete catalog of supported realtime voice providers and their respective capabilities.

Our engine aggregates multiple state-of-the-art Voice AI providers into a single interface. This endpoint acts as a "discovery" route, returning all the configuration data you need to build dynamic agent-creation forms in your own UI.

<Info>
  **Authentication Required:** You must include your API key in the `x-api-key` header to authenticate this request.
</Info>

### Understanding the Configuration Payload

A successful request returns a `providers` array. Currently, the API supports leading realtime engines including **OpenAI**, **Gemini**, **Ultravox**, and **xAI Grok**.

Each provider object contains the following nested data:

* **`models`**: The specific realtime models available (e.g., `gpt-realtime`, `gemini-2.5-flash-native-audio`).
* **`languages`**: Found inside each model object, this is an extensive array of supported ISO language codes (like `en`, `es`, `hi`, `ja`) indicating what languages the model can natively understand and speak.
* **`voices`**: The available voice identities you can apply to the agent.


## OpenAPI

````yaml get /config/realtime-options
openapi: 3.0.3
info:
  title: Lyzr Voice LiveKit API
  version: 1.0.0
servers:
  - url: https://voice-livekit.studio.lyzr.ai/v1
security: []
paths:
  /config/realtime-options:
    get:
      summary: List Realtime Options
      description: >-
        Retrieve a comprehensive list of all supported realtime voice providers,
        their available models, supported languages, voice configurations, and
        required environment variables.
      responses:
        '200':
          description: Realtime options retrieved successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  providers:
                    type: array
                    items:
                      type: object
                      properties:
                        providerId:
                          type: string
                          description: The internal ID of the provider.
                          example: openai
                        displayName:
                          type: string
                          description: The human-readable name of the provider.
                          example: OpenAI
                        models:
                          type: array
                          description: A list of realtime models offered by this provider.
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                                example: gpt-realtime
                              name:
                                type: string
                                example: gpt-realtime
                              languages:
                                type: array
                                description: Array of supported language codes (ISO 639-1).
                                items:
                                  type: string
                                  example: en
                        voices:
                          type: array
                          description: >-
                            A list of available voice clones/synthesizers for
                            this provider.
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                                example: alloy
                              name:
                                type: string
                                example: Alloy
                              description:
                                type: string
                                example: Neutral and balanced
                              previewUrl:
                                type: string
                                description: >-
                                  An optional URL to an audio sample of the
                                  voice.
                                example: >-
                                  https://gstatic.com/aistudio/voices/samples/Zephyr.wav
                        requiredEnv:
                          type: array
                          description: >-
                            The environment variable keys required to
                            authenticate with this provider.
                          items:
                            type: string
                            example: OPENAI_API_KEY
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````