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

# Get available models (OpenAI-compatible)

> Lists every model currently available to your account on Telnyx Inference, including SOTA open-source LLMs hosted on Telnyx GPUs (for example `moonshotai/Kimi-K2.6`, `zai-org/GLM-5.1-FP8`, and `MiniMaxAI/MiniMax-M2.7`), embedding models, and any fine-tuned models you have created.

Each entry is a `ModelMetadata` object describing the model id, owner, task, context length, supported languages, billing tier, pricing per 1M tokens, deployment regions, and whether the model supports vision or fine-tuning. Use this endpoint to discover model ids you can pass to `POST /v2/ai/openai/chat/completions`.

Model ids follow the `{organization}/{model_name}` convention from Hugging Face (for example `moonshotai/Kimi-K2.6`). This endpoint is OpenAI-compatible: clients pointed at `https://api.telnyx.com/v2/ai/openai` can call `client.models.list()` to retrieve the same payload.



## OpenAPI

````yaml https://telnyx-openapi-ng.s3.us-east-1.amazonaws.com/ai/inference.yml get /ai/openai/models
openapi: 3.1.0
info:
  title: Telnyx AI Inference API
  version: 2.0.0
  description: API for AI inference, including chat completions, fine-tuning, and models.
  contact:
    email: support@telnyx.com
servers:
  - url: https://api.telnyx.com/v2
security:
  - bearerAuth: []
paths:
  /ai/openai/models:
    get:
      tags:
        - OpenAI Chat
      summary: Get available models (OpenAI-compatible)
      description: >-
        Lists every model currently available to your account on Telnyx
        Inference, including SOTA open-source LLMs hosted on Telnyx GPUs (for
        example `moonshotai/Kimi-K2.6`, `zai-org/GLM-5.1-FP8`, and
        `MiniMaxAI/MiniMax-M2.7`), embedding models, and any fine-tuned models
        you have created.


        Each entry is a `ModelMetadata` object describing the model id, owner,
        task, context length, supported languages, billing tier, pricing per 1M
        tokens, deployment regions, and whether the model supports vision or
        fine-tuning. Use this endpoint to discover model ids you can pass to
        `POST /v2/ai/openai/chat/completions`.


        Model ids follow the `{organization}/{model_name}` convention from
        Hugging Face (for example `moonshotai/Kimi-K2.6`). This endpoint is
        OpenAI-compatible: clients pointed at
        `https://api.telnyx.com/v2/ai/openai` can call `client.models.list()` to
        retrieve the same payload.
      operationId: list_openai_models
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelsResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-codeSamples:
        - lang: JavaScript
          source: |-
            import Telnyx from 'telnyx';

            const client = new Telnyx({
              apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
            });

            const response = await client.ai.openai.listModels();

            console.log(response.data);
        - lang: Python
          source: |-
            import os
            from telnyx import Telnyx

            client = Telnyx(
                api_key=os.environ.get("TELNYX_API_KEY"),  # This is the default and can be omitted
            )
            response = client.ai.openai.list_models()
            print(response.data)
        - lang: Go
          source: "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/team-telnyx/telnyx-go\"\n\t\"github.com/team-telnyx/telnyx-go/option\"\n)\n\nfunc main() {\n\tclient := telnyx.NewClient(\n\t\toption.WithAPIKey(\"My API Key\"),\n\t)\n\tresponse, err := client.AI.OpenAI.ListModels(context.TODO())\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", response.Data)\n}\n"
        - lang: Java
          source: |-
            package com.telnyx.sdk.example;

            import com.telnyx.sdk.client.TelnyxClient;
            import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;
            import com.telnyx.sdk.models.ai.openai.OpenAIListModelsParams;
            import com.telnyx.sdk.models.ai.openai.OpenAIListModelsResponse;

            public final class Main {
                private Main() {}

                public static void main(String[] args) {
                    TelnyxClient client = TelnyxOkHttpClient.fromEnv();

                    OpenAIListModelsResponse response = client.ai().openai().listModels();
                }
            }
        - lang: Ruby
          source: |-
            require "telnyx"

            telnyx = Telnyx::Client.new(api_key: "My API Key")

            response = telnyx.ai.openai.list_models

            puts(response)
        - lang: PHP
          source: >-
            <?php


            require_once dirname(__DIR__) . '/vendor/autoload.php';


            use Telnyx\Client;

            use Telnyx\Core\Exceptions\APIException;


            $client = new Client(apiKey: getenv('TELNYX_API_KEY') ?: 'My API
            Key');


            try {
              $response = $client->ai->openai->listModels();

              var_dump($response);
            } catch (APIException $e) {
              echo $e->getMessage();
            }
        - lang: CLI
          source: |-
            telnyx ai:openai list-models \
              --api-key 'My API Key'
components:
  schemas:
    ModelsResponse:
      properties:
        object:
          type: string
          title: Object
          default: list
        data:
          items:
            $ref: '#/components/schemas/ModelMetadata'
          type: array
          title: Data
      type: object
      required:
        - data
      title: ModelsResponse
    HTTPValidationError:
      title: HTTPValidationError
      type: object
      properties:
        detail:
          title: Detail
          type: array
          items:
            $ref: '#/components/schemas/ValidationError'
    ModelMetadata:
      type: object
      title: ModelMetadata
      description: >-
        Metadata for a model available on Telnyx Inference. Returned by `GET
        /v2/ai/openai/models` (and the deprecated `GET /v2/ai/models`).
        Open-source models live under their Hugging Face organization (e.g.
        `moonshotai/Kimi-K2.6`, `zai-org/GLM-5.1-FP8`,
        `MiniMaxAI/MiniMax-M2.7`); fine-tuned models are owned by the Telnyx
        organization that trained them.
      required:
        - id
        - created
        - owned_by
        - organization
        - context_length
        - languages
        - parameters
        - tier
        - license
      properties:
        id:
          type: string
          title: Id
          description: >-
            Model identifier. For open-source models, follows the
            `{organization}/{model_name}` convention from Hugging Face (e.g.
            `moonshotai/Kimi-K2.6`).
          example: moonshotai/Kimi-K2.6
        object:
          type: string
          title: Object
          default: model
          description: Object type. Always `model`.
        created:
          type: string
          format: date-time
          title: Created
          description: >-
            Timestamp at which the model was registered on Telnyx Inference (ISO
            8601).
        base_model:
          type:
            - string
            - 'null'
          title: Base Model
          description: >-
            Base model the fine-tuned model was trained from. Only set for
            fine-tuned models.
        owned_by:
          type: string
          title: Owned By
          description: >-
            Owner of the model. `Telnyx` for Telnyx-hosted open-source models,
            the upstream provider name for proxied models, or the Telnyx
            organization id for fine-tuned models.
          example: Telnyx
        organization:
          type: string
          title: Organization
          description: >-
            Organization that originally published the model, matching the
            prefix of `id` for open-source models.
          example: moonshotai
        task:
          type: string
          title: Task
          default: text-generation
          description: >-
            Primary task the model is intended for, e.g. `text-generation`,
            `audio-text-to-text`, `feature-extraction` (embeddings).
          example: text-generation
        context_length:
          type: integer
          title: Context Length
          description: >-
            Maximum total tokens (prompt + completion) supported by the model in
            a single request.
          example: 262144
        max_completion_tokens:
          type:
            - integer
            - 'null'
          title: Max Completion Tokens
          description: >-
            Maximum number of completion (output) tokens the model will generate
            per request. `null` if unconstrained beyond `context_length`.
        languages:
          type: array
          title: Languages
          items:
            type: string
          description: ISO language codes the model supports (e.g. `en`, `es`).
        parameters:
          type: integer
          title: Parameters
          description: Total parameter count of the model.
          example: 1000000000000
        parameters_str:
          type:
            - string
            - 'null'
          title: Parameters (human readable)
          description: Human-readable parameter count, e.g. `1.0T`, `753.9B`, `8B`.
          example: 1.0T
        tier:
          type: string
          title: Tier
          enum:
            - small
            - medium
            - large
            - unlisted
          description: >-
            Billing tier the model belongs to. Used together with `pricing` to
            determine cost per 1M tokens.
        license:
          type: string
          title: License
          description: >-
            License the model is distributed under, e.g. `Apache 2.0`, `MIT`,
            `Llama 3 Community License`.
        is_fine_tunable:
          type: boolean
          title: Is Fine Tunable
          default: false
          description: >-
            Whether the model can be used as a base for a fine-tuning job via
            `POST /v2/ai/fine_tuning/jobs`.
        recommended_for_assistants:
          type: boolean
          title: Recommended For Assistants
          default: false
          description: >-
            Whether Telnyx currently recommends this model as the LLM powering a
            Telnyx AI Assistant.
        is_vision_supported:
          type: boolean
          title: Is Vision Supported
          default: false
          description: >-
            Whether the model accepts image inputs in chat completions
            (multimodal vision support).
        description:
          type:
            - string
            - 'null'
          title: Description
          description: Short, human-readable summary of what the model is best suited for.
        pricing:
          type: object
          title: Pricing
          additionalProperties:
            type: string
          description: >-
            Mapping of token kind to price, as strings to preserve precision.
            Typical keys are `prompt`, `cached_prompt`, and `completion`. When
            pricing is available the block also includes `currency` (ISO 4217
            code matching the account's configured billing currency) and `unit`
            (the denomination the prices are quoted in, currently always
            `1M_tokens` for token-priced models).
          example:
            prompt: '0.300000'
            completion: '1.200000'
            cached_prompt: '0.060000'
            currency: USD
            unit: 1M_tokens
        regions:
          type: array
          title: Regions
          items:
            type: string
          description: >-
            Public region names where the model is currently deployed (e.g.
            `us-central-1`, `eu-central-1`).
          example:
            - us-central-1
            - us-east-1
    ValidationError:
      title: ValidationError
      required:
        - loc
        - msg
        - type
      type: object
      properties:
        loc:
          title: Location
          type: array
          items:
            anyOf:
              - type: string
              - type: integer
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````