telnyx 5.105.0 → 5.106.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 00c56398477600183f977eeff58815a2cc7aaa8c9698ff8f56b59b27590bdd35
-  data.tar.gz: c2d9c2b3c47e12c4360a49835a7dcc46e68113a83b83d19ee2ae6ee27fc1b86e
+  metadata.gz: c40ebb14623acd3df51f2cd6eb3c5b1978936b42835dbf93f611e8a0a599ff7a
+  data.tar.gz: 936c360c1278f930e62111b8957b6f594ebd53be542f99983c12956f2ce0caf1
 SHA512:
-  metadata.gz: fce247576924b863af47b999bc829f893d9fd60dfc2678b6589eb6ae54f61ba447c1575516d324e8cdc2ff348bbb38be6e101ec74caa5f4d170f3b678d7d4a7d
-  data.tar.gz: 5a26d164a5e24c72e4d6d83e18ad6a0339ee98d3e5c09379021a24203130c4e5267cdf308030271005e02e3f6465e6213a3d13bdcbb39b80e2bf660ba6d3702d
+  metadata.gz: 4da3bea0b147d4c8084e9f86a4aa4328348e5020a8a60d4487c3b8954165fccdb661dd8d326da264852249c27b77cde02e7bba4de97dbd224531b5280cadef72
+  data.tar.gz: b5919a5f7b79f7fea42fc6e99f5d708dae9655d8b5838db050707464a677d4128b5be6278059a4de3060b93f001dc01fbe849f2d5b24e4d5bf2829e74ba67b13

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 5.106.0 (2026-05-08)
+
+Full Changelog: [v5.105.0...v5.106.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.105.0...v5.106.0)
+
+### Features
+
+* AI-2294: document /ai/openai/models response and refresh LLM examples ([fe820e3](https://github.com/team-telnyx/telnyx-ruby/commit/fe820e34daed754d06fb23d9667442e154fe51c9))
+
 ## 5.105.0 (2026-05-08)
 
 Full Changelog: [v5.104.0...v5.105.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.104.0...v5.105.0)

data/README.md

@@ -24,7 +24,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "telnyx", "~> 5.105.0"
+gem "telnyx", "~> 5.106.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/telnyx/models/model_metadata.rb

@@ -4,30 +4,207 @@ module Telnyx
   module Models
     class ModelMetadata < Telnyx::Internal::Type::BaseModel
       # @!attribute id
+      #   Model identifier. For open-source models, follows the
+      #   `{organization}/{model_name}` convention from Hugging Face (e.g.
+      #   `moonshotai/Kimi-K2.6`).
       #
       #   @return [String]
       required :id, String
 
-      # @!attribute created
+      # @!attribute context_length
+      #   Maximum total tokens (prompt + completion) supported by the model in a single
+      #   request.
       #
       #   @return [Integer]
-      required :created, Integer
+      required :context_length, Integer
+
+      # @!attribute created
+      #   Timestamp at which the model was registered on Telnyx Inference (ISO 8601).
+      #
+      #   @return [Time]
+      required :created, Time
+
+      # @!attribute languages
+      #   ISO language codes the model supports (e.g. `en`, `es`).
+      #
+      #   @return [Array<String>]
+      required :languages, Telnyx::Internal::Type::ArrayOf[String]
+
+      # @!attribute license
+      #   License the model is distributed under, e.g. `Apache 2.0`, `MIT`,
+      #   `Llama 3 Community License`.
+      #
+      #   @return [String]
+      required :license, String
+
+      # @!attribute organization
+      #   Organization that originally published the model, matching the prefix of `id`
+      #   for open-source models.
+      #
+      #   @return [String]
+      required :organization, String
 
       # @!attribute owned_by
+      #   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.
       #
       #   @return [String]
       required :owned_by, String
 
+      # @!attribute parameters
+      #   Total parameter count of the model.
+      #
+      #   @return [Integer]
+      required :parameters, Integer
+
+      # @!attribute tier
+      #   Billing tier the model belongs to. Used together with `pricing` to determine
+      #   cost per 1M tokens.
+      #
+      #   @return [Symbol, Telnyx::Models::ModelMetadata::Tier]
+      required :tier, enum: -> { Telnyx::ModelMetadata::Tier }
+
+      # @!attribute base_model
+      #   Base model the fine-tuned model was trained from. Only set for fine-tuned
+      #   models.
+      #
+      #   @return [String, nil]
+      optional :base_model, String, nil?: true
+
+      # @!attribute description
+      #   Short, human-readable summary of what the model is best suited for.
+      #
+      #   @return [String, nil]
+      optional :description, String, nil?: true
+
+      # @!attribute is_fine_tunable
+      #   Whether the model can be used as a base for a fine-tuning job via
+      #   `POST /v2/ai/fine_tuning/jobs`.
+      #
+      #   @return [Boolean, nil]
+      optional :is_fine_tunable, Telnyx::Internal::Type::Boolean
+
+      # @!attribute is_vision_supported
+      #   Whether the model accepts image inputs in chat completions (multimodal vision
+      #   support).
+      #
+      #   @return [Boolean, nil]
+      optional :is_vision_supported, Telnyx::Internal::Type::Boolean
+
+      # @!attribute max_completion_tokens
+      #   Maximum number of completion (output) tokens the model will generate per
+      #   request. `null` if unconstrained beyond `context_length`.
+      #
+      #   @return [Integer, nil]
+      optional :max_completion_tokens, Integer, nil?: true
+
       # @!attribute object
+      #   Object type. Always `model`.
       #
       #   @return [String, nil]
       optional :object, String
 
-      # @!method initialize(id:, created:, owned_by:, object: nil)
-      #   @param id [String]
-      #   @param created [Integer]
-      #   @param owned_by [String]
-      #   @param object [String]
+      # @!attribute parameters_str
+      #   Human-readable parameter count, e.g. `1.0T`, `753.9B`, `8B`.
+      #
+      #   @return [String, nil]
+      optional :parameters_str, String, nil?: true
+
+      # @!attribute pricing
+      #   Mapping of token kind to price in USD per 1M tokens, as a string. Typical keys
+      #   are `input` and `output`; embedding models expose `embedding`. Empty object when
+      #   pricing is not yet published for the model.
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :pricing, Telnyx::Internal::Type::HashOf[String]
+
+      # @!attribute recommended_for_assistants
+      #   Whether Telnyx currently recommends this model as the LLM powering a Telnyx AI
+      #   Assistant.
+      #
+      #   @return [Boolean, nil]
+      optional :recommended_for_assistants, Telnyx::Internal::Type::Boolean
+
+      # @!attribute regions
+      #   Public region names where the model is currently deployed (e.g. `us-central-1`,
+      #   `eu-central-1`).
+      #
+      #   @return [Array<String>, nil]
+      optional :regions, Telnyx::Internal::Type::ArrayOf[String]
+
+      # @!attribute task
+      #   Primary task the model is intended for, e.g. `text-generation`,
+      #   `audio-text-to-text`, `feature-extraction` (embeddings).
+      #
+      #   @return [String, nil]
+      optional :task, String
+
+      # @!method initialize(id:, context_length:, created:, languages:, license:, organization:, owned_by:, parameters:, tier:, base_model: nil, description: nil, is_fine_tunable: nil, is_vision_supported: nil, max_completion_tokens: nil, object: nil, parameters_str: nil, pricing: nil, recommended_for_assistants: nil, regions: nil, task: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::ModelMetadata} for more details.
+      #
+      #   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.
+      #
+      #   @param id [String] Model identifier. For open-source models, follows the `{organization}/{model_nam
+      #
+      #   @param context_length [Integer] Maximum total tokens (prompt + completion) supported by the model in a single re
+      #
+      #   @param created [Time] Timestamp at which the model was registered on Telnyx Inference (ISO 8601).
+      #
+      #   @param languages [Array<String>] ISO language codes the model supports (e.g. `en`, `es`).
+      #
+      #   @param license [String] License the model is distributed under, e.g. `Apache 2.0`, `MIT`, `Llama 3 Commu
+      #
+      #   @param organization [String] Organization that originally published the model, matching the prefix of `id` fo
+      #
+      #   @param owned_by [String] Owner of the model. `Telnyx` for Telnyx-hosted open-source models, the upstream
+      #
+      #   @param parameters [Integer] Total parameter count of the model.
+      #
+      #   @param tier [Symbol, Telnyx::Models::ModelMetadata::Tier] Billing tier the model belongs to. Used together with `pricing` to determine cos
+      #
+      #   @param base_model [String, nil] Base model the fine-tuned model was trained from. Only set for fine-tuned models
+      #
+      #   @param description [String, nil] Short, human-readable summary of what the model is best suited for.
+      #
+      #   @param is_fine_tunable [Boolean] Whether the model can be used as a base for a fine-tuning job via `POST /v2/ai/f
+      #
+      #   @param is_vision_supported [Boolean] Whether the model accepts image inputs in chat completions (multimodal vision su
+      #
+      #   @param max_completion_tokens [Integer, nil] Maximum number of completion (output) tokens the model will generate per request
+      #
+      #   @param object [String] Object type. Always `model`.
+      #
+      #   @param parameters_str [String, nil] Human-readable parameter count, e.g. `1.0T`, `753.9B`, `8B`.
+      #
+      #   @param pricing [Hash{Symbol=>String}] Mapping of token kind to price in USD per 1M tokens, as a string. Typical keys a
+      #
+      #   @param recommended_for_assistants [Boolean] Whether Telnyx currently recommends this model as the LLM powering a Telnyx AI A
+      #
+      #   @param regions [Array<String>] Public region names where the model is currently deployed (e.g. `us-central-1`,
+      #
+      #   @param task [String] Primary task the model is intended for, e.g. `text-generation`, `audio-text-to-t
+
+      # Billing tier the model belongs to. Used together with `pricing` to determine
+      # cost per 1M tokens.
+      #
+      # @see Telnyx::Models::ModelMetadata#tier
+      module Tier
+        extend Telnyx::Internal::Type::Enum
+
+        SMALL = :small
+        MEDIUM = :medium
+        LARGE = :large
+        UNLISTED = :unlisted
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/telnyx/resources/ai/openai.rb

@@ -12,11 +12,21 @@ module Telnyx
         # @return [Telnyx::Resources::AI::OpenAI::Chat]
         attr_reader :chat
 
-        # This endpoint returns a list of Open Source and OpenAI models that are available
-        # for use. <br /><br /> **Note**: Model `id`'s will be in the form
-        # `{source}/{model_name}`. For example `openai/gpt-4` or
-        # `mistralai/Mistral-7B-Instruct-v0.1` consistent with HuggingFace naming
-        # conventions.
+        # 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.
         #
         # @overload list_models(request_options: {})
         #

data/lib/telnyx/resources/ai.rb

@@ -48,11 +48,15 @@ module Telnyx
 
       # @deprecated
       #
-      # **Deprecated**: Use `GET /v2/ai/openai/models` instead. This endpoint returns a
-      # list of Open Source and OpenAI models that are available for use. <br /><br />
-      # **Note**: Model `id`'s will be in the form `{source}/{model_name}`. For example
-      # `openai/gpt-4` or `mistralai/Mistral-7B-Instruct-v0.1` consistent with
-      # HuggingFace naming conventions.
+      # **Deprecated**: Use `GET /v2/ai/openai/models` instead.
+      #
+      # Returns the same `ModelsResponse` payload as the OpenAI-compatible endpoint —
+      # open-source LLMs hosted on Telnyx (e.g. `moonshotai/Kimi-K2.6`,
+      # `zai-org/GLM-5.1-FP8`, `MiniMaxAI/MiniMax-M2.7`), embedding models, and
+      # fine-tuned models — kept around for backwards compatibility. New integrations
+      # should use `/v2/ai/openai/models`.
+      #
+      # Model ids follow the `{organization}/{model_name}` convention from Hugging Face.
       #
       # @overload retrieve_models(request_options: {})
       #

data/lib/telnyx/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Telnyx
-  VERSION = "5.105.0"
+  VERSION = "5.106.0"
 end

data/rbi/telnyx/models/model_metadata.rbi

@@ -6,39 +6,263 @@ module Telnyx
       OrHash =
         T.type_alias { T.any(Telnyx::ModelMetadata, Telnyx::Internal::AnyHash) }
 
+      # Model identifier. For open-source models, follows the
+      # `{organization}/{model_name}` convention from Hugging Face (e.g.
+      # `moonshotai/Kimi-K2.6`).
       sig { returns(String) }
       attr_accessor :id
 
+      # Maximum total tokens (prompt + completion) supported by the model in a single
+      # request.
       sig { returns(Integer) }
+      attr_accessor :context_length
+
+      # Timestamp at which the model was registered on Telnyx Inference (ISO 8601).
+      sig { returns(Time) }
       attr_accessor :created
 
+      # ISO language codes the model supports (e.g. `en`, `es`).
+      sig { returns(T::Array[String]) }
+      attr_accessor :languages
+
+      # License the model is distributed under, e.g. `Apache 2.0`, `MIT`,
+      # `Llama 3 Community License`.
+      sig { returns(String) }
+      attr_accessor :license
+
+      # Organization that originally published the model, matching the prefix of `id`
+      # for open-source models.
+      sig { returns(String) }
+      attr_accessor :organization
+
+      # 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.
       sig { returns(String) }
       attr_accessor :owned_by
 
+      # Total parameter count of the model.
+      sig { returns(Integer) }
+      attr_accessor :parameters
+
+      # Billing tier the model belongs to. Used together with `pricing` to determine
+      # cost per 1M tokens.
+      sig { returns(Telnyx::ModelMetadata::Tier::TaggedSymbol) }
+      attr_accessor :tier
+
+      # Base model the fine-tuned model was trained from. Only set for fine-tuned
+      # models.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :base_model
+
+      # Short, human-readable summary of what the model is best suited for.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :description
+
+      # Whether the model can be used as a base for a fine-tuning job via
+      # `POST /v2/ai/fine_tuning/jobs`.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :is_fine_tunable
+
+      sig { params(is_fine_tunable: T::Boolean).void }
+      attr_writer :is_fine_tunable
+
+      # Whether the model accepts image inputs in chat completions (multimodal vision
+      # support).
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :is_vision_supported
+
+      sig { params(is_vision_supported: T::Boolean).void }
+      attr_writer :is_vision_supported
+
+      # Maximum number of completion (output) tokens the model will generate per
+      # request. `null` if unconstrained beyond `context_length`.
+      sig { returns(T.nilable(Integer)) }
+      attr_accessor :max_completion_tokens
+
+      # Object type. Always `model`.
       sig { returns(T.nilable(String)) }
       attr_reader :object
 
       sig { params(object: String).void }
       attr_writer :object
 
+      # Human-readable parameter count, e.g. `1.0T`, `753.9B`, `8B`.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :parameters_str
+
+      # Mapping of token kind to price in USD per 1M tokens, as a string. Typical keys
+      # are `input` and `output`; embedding models expose `embedding`. Empty object when
+      # pricing is not yet published for the model.
+      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      attr_reader :pricing
+
+      sig { params(pricing: T::Hash[Symbol, String]).void }
+      attr_writer :pricing
+
+      # Whether Telnyx currently recommends this model as the LLM powering a Telnyx AI
+      # Assistant.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :recommended_for_assistants
+
+      sig { params(recommended_for_assistants: T::Boolean).void }
+      attr_writer :recommended_for_assistants
+
+      # Public region names where the model is currently deployed (e.g. `us-central-1`,
+      # `eu-central-1`).
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_reader :regions
+
+      sig { params(regions: T::Array[String]).void }
+      attr_writer :regions
+
+      # Primary task the model is intended for, e.g. `text-generation`,
+      # `audio-text-to-text`, `feature-extraction` (embeddings).
+      sig { returns(T.nilable(String)) }
+      attr_reader :task
+
+      sig { params(task: String).void }
+      attr_writer :task
+
+      # 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.
       sig do
         params(
           id: String,
-          created: Integer,
+          context_length: Integer,
+          created: Time,
+          languages: T::Array[String],
+          license: String,
+          organization: String,
           owned_by: String,
-          object: String
+          parameters: Integer,
+          tier: Telnyx::ModelMetadata::Tier::OrSymbol,
+          base_model: T.nilable(String),
+          description: T.nilable(String),
+          is_fine_tunable: T::Boolean,
+          is_vision_supported: T::Boolean,
+          max_completion_tokens: T.nilable(Integer),
+          object: String,
+          parameters_str: T.nilable(String),
+          pricing: T::Hash[Symbol, String],
+          recommended_for_assistants: T::Boolean,
+          regions: T::Array[String],
+          task: String
         ).returns(T.attached_class)
       end
-      def self.new(id:, created:, owned_by:, object: nil)
+      def self.new(
+        # Model identifier. For open-source models, follows the
+        # `{organization}/{model_name}` convention from Hugging Face (e.g.
+        # `moonshotai/Kimi-K2.6`).
+        id:,
+        # Maximum total tokens (prompt + completion) supported by the model in a single
+        # request.
+        context_length:,
+        # Timestamp at which the model was registered on Telnyx Inference (ISO 8601).
+        created:,
+        # ISO language codes the model supports (e.g. `en`, `es`).
+        languages:,
+        # License the model is distributed under, e.g. `Apache 2.0`, `MIT`,
+        # `Llama 3 Community License`.
+        license:,
+        # Organization that originally published the model, matching the prefix of `id`
+        # for open-source models.
+        organization:,
+        # 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.
+        owned_by:,
+        # Total parameter count of the model.
+        parameters:,
+        # Billing tier the model belongs to. Used together with `pricing` to determine
+        # cost per 1M tokens.
+        tier:,
+        # Base model the fine-tuned model was trained from. Only set for fine-tuned
+        # models.
+        base_model: nil,
+        # Short, human-readable summary of what the model is best suited for.
+        description: nil,
+        # Whether the model can be used as a base for a fine-tuning job via
+        # `POST /v2/ai/fine_tuning/jobs`.
+        is_fine_tunable: nil,
+        # Whether the model accepts image inputs in chat completions (multimodal vision
+        # support).
+        is_vision_supported: nil,
+        # Maximum number of completion (output) tokens the model will generate per
+        # request. `null` if unconstrained beyond `context_length`.
+        max_completion_tokens: nil,
+        # Object type. Always `model`.
+        object: nil,
+        # Human-readable parameter count, e.g. `1.0T`, `753.9B`, `8B`.
+        parameters_str: nil,
+        # Mapping of token kind to price in USD per 1M tokens, as a string. Typical keys
+        # are `input` and `output`; embedding models expose `embedding`. Empty object when
+        # pricing is not yet published for the model.
+        pricing: nil,
+        # Whether Telnyx currently recommends this model as the LLM powering a Telnyx AI
+        # Assistant.
+        recommended_for_assistants: nil,
+        # Public region names where the model is currently deployed (e.g. `us-central-1`,
+        # `eu-central-1`).
+        regions: nil,
+        # Primary task the model is intended for, e.g. `text-generation`,
+        # `audio-text-to-text`, `feature-extraction` (embeddings).
+        task: nil
+      )
       end
 
       sig do
         override.returns(
-          { id: String, created: Integer, owned_by: String, object: String }
+          {
+            id: String,
+            context_length: Integer,
+            created: Time,
+            languages: T::Array[String],
+            license: String,
+            organization: String,
+            owned_by: String,
+            parameters: Integer,
+            tier: Telnyx::ModelMetadata::Tier::TaggedSymbol,
+            base_model: T.nilable(String),
+            description: T.nilable(String),
+            is_fine_tunable: T::Boolean,
+            is_vision_supported: T::Boolean,
+            max_completion_tokens: T.nilable(Integer),
+            object: String,
+            parameters_str: T.nilable(String),
+            pricing: T::Hash[Symbol, String],
+            recommended_for_assistants: T::Boolean,
+            regions: T::Array[String],
+            task: String
+          }
         )
       end
       def to_hash
       end
+
+      # Billing tier the model belongs to. Used together with `pricing` to determine
+      # cost per 1M tokens.
+      module Tier
+        extend Telnyx::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Telnyx::ModelMetadata::Tier) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        SMALL = T.let(:small, Telnyx::ModelMetadata::Tier::TaggedSymbol)
+        MEDIUM = T.let(:medium, Telnyx::ModelMetadata::Tier::TaggedSymbol)
+        LARGE = T.let(:large, Telnyx::ModelMetadata::Tier::TaggedSymbol)
+        UNLISTED = T.let(:unlisted, Telnyx::ModelMetadata::Tier::TaggedSymbol)
+
+        sig do
+          override.returns(T::Array[Telnyx::ModelMetadata::Tier::TaggedSymbol])
+        end
+        def self.values
+        end
+      end
     end
   end
 end

data/rbi/telnyx/resources/ai/openai.rbi

@@ -12,11 +12,21 @@ module Telnyx
         sig { returns(Telnyx::Resources::AI::OpenAI::Chat) }
         attr_reader :chat
 
-        # This endpoint returns a list of Open Source and OpenAI models that are available
-        # for use. <br /><br /> **Note**: Model `id`'s will be in the form
-        # `{source}/{model_name}`. For example `openai/gpt-4` or
-        # `mistralai/Mistral-7B-Instruct-v0.1` consistent with HuggingFace naming
-        # conventions.
+        # 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.
         sig do
           params(request_options: Telnyx::RequestOptions::OrHash).returns(
             Telnyx::Models::AI::OpenAIListModelsResponse

data/rbi/telnyx/resources/ai.rbi

@@ -46,11 +46,15 @@ module Telnyx
       sig { returns(Telnyx::Resources::AI::Tools) }
       attr_reader :tools
 
-      # **Deprecated**: Use `GET /v2/ai/openai/models` instead. This endpoint returns a
-      # list of Open Source and OpenAI models that are available for use. <br /><br />
-      # **Note**: Model `id`'s will be in the form `{source}/{model_name}`. For example
-      # `openai/gpt-4` or `mistralai/Mistral-7B-Instruct-v0.1` consistent with
-      # HuggingFace naming conventions.
+      # **Deprecated**: Use `GET /v2/ai/openai/models` instead.
+      #
+      # Returns the same `ModelsResponse` payload as the OpenAI-compatible endpoint —
+      # open-source LLMs hosted on Telnyx (e.g. `moonshotai/Kimi-K2.6`,
+      # `zai-org/GLM-5.1-FP8`, `MiniMaxAI/MiniMax-M2.7`), embedding models, and
+      # fine-tuned models — kept around for backwards compatibility. New integrations
+      # should use `/v2/ai/openai/models`.
+      #
+      # Model ids follow the `{organization}/{model_name}` convention from Hugging Face.
       sig do
         params(request_options: Telnyx::RequestOptions::OrHash).returns(
           Telnyx::Models::AIRetrieveModelsResponse

data/sig/telnyx/models/model_metadata.rbs

@@ -1,32 +1,142 @@
 module Telnyx
   module Models
     type model_metadata =
-      { id: String, created: Integer, owned_by: String, object: String }
+      {
+        id: String,
+        context_length: Integer,
+        created: Time,
+        languages: ::Array[String],
+        license: String,
+        organization: String,
+        owned_by: String,
+        parameters: Integer,
+        tier: Telnyx::Models::ModelMetadata::tier,
+        base_model: String?,
+        description: String?,
+        is_fine_tunable: bool,
+        is_vision_supported: bool,
+        max_completion_tokens: Integer?,
+        object: String,
+        parameters_str: String?,
+        pricing: ::Hash[Symbol, String],
+        recommended_for_assistants: bool,
+        regions: ::Array[String],
+        task: String
+      }
 
     class ModelMetadata < Telnyx::Internal::Type::BaseModel
       attr_accessor id: String
 
-      attr_accessor created: Integer
+      attr_accessor context_length: Integer
+
+      attr_accessor created: Time
+
+      attr_accessor languages: ::Array[String]
+
+      attr_accessor license: String
+
+      attr_accessor organization: String
 
       attr_accessor owned_by: String
 
+      attr_accessor parameters: Integer
+
+      attr_accessor tier: Telnyx::Models::ModelMetadata::tier
+
+      attr_accessor base_model: String?
+
+      attr_accessor description: String?
+
+      attr_reader is_fine_tunable: bool?
+
+      def is_fine_tunable=: (bool) -> bool
+
+      attr_reader is_vision_supported: bool?
+
+      def is_vision_supported=: (bool) -> bool
+
+      attr_accessor max_completion_tokens: Integer?
+
       attr_reader object: String?
 
       def object=: (String) -> String
 
+      attr_accessor parameters_str: String?
+
+      attr_reader pricing: ::Hash[Symbol, String]?
+
+      def pricing=: (::Hash[Symbol, String]) -> ::Hash[Symbol, String]
+
+      attr_reader recommended_for_assistants: bool?
+
+      def recommended_for_assistants=: (bool) -> bool
+
+      attr_reader regions: ::Array[String]?
+
+      def regions=: (::Array[String]) -> ::Array[String]
+
+      attr_reader task: String?
+
+      def task=: (String) -> String
+
       def initialize: (
         id: String,
-        created: Integer,
+        context_length: Integer,
+        created: Time,
+        languages: ::Array[String],
+        license: String,
+        organization: String,
         owned_by: String,
-        ?object: String
+        parameters: Integer,
+        tier: Telnyx::Models::ModelMetadata::tier,
+        ?base_model: String?,
+        ?description: String?,
+        ?is_fine_tunable: bool,
+        ?is_vision_supported: bool,
+        ?max_completion_tokens: Integer?,
+        ?object: String,
+        ?parameters_str: String?,
+        ?pricing: ::Hash[Symbol, String],
+        ?recommended_for_assistants: bool,
+        ?regions: ::Array[String],
+        ?task: String
       ) -> void
 
       def to_hash: -> {
         id: String,
-        created: Integer,
+        context_length: Integer,
+        created: Time,
+        languages: ::Array[String],
+        license: String,
+        organization: String,
         owned_by: String,
-        object: String
+        parameters: Integer,
+        tier: Telnyx::Models::ModelMetadata::tier,
+        base_model: String?,
+        description: String?,
+        is_fine_tunable: bool,
+        is_vision_supported: bool,
+        max_completion_tokens: Integer?,
+        object: String,
+        parameters_str: String?,
+        pricing: ::Hash[Symbol, String],
+        recommended_for_assistants: bool,
+        regions: ::Array[String],
+        task: String
       }
+
+      type tier = :small | :medium | :large | :unlisted
+
+      module Tier
+        extend Telnyx::Internal::Type::Enum
+
+        SMALL: :small
+        MEDIUM: :medium
+        LARGE: :large
+        UNLISTED: :unlisted
+
+        def self?.values: -> ::Array[Telnyx::Models::ModelMetadata::tier]
+      end
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: telnyx
 version: !ruby/object:Gem::Version
-  version: 5.105.0
+  version: 5.106.0
 platform: ruby
 authors:
 - Telnyx