telnyx 5.100.0 → 5.101.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f543aaa2a4a47c27cf247a82e0429a022bf94d6f58102f18b4cc50c7f9d9a1f4
-  data.tar.gz: f1091cc87e194f413294bde65188a2908f1292396c5c72e569514994d9e719ea
+  metadata.gz: b788d1ec382c32e4625205edebf53eb059dc17bcd9d695140ba97acb0d79364c
+  data.tar.gz: 4c680da1dbfbce503ac6fd68ad1367a3c1c357746df9fcbbc9cc487860bf15e2
 SHA512:
-  metadata.gz: 75071192dfd36a1c38a93d98d681396c5c5016b9924c88de59a0a3ffe7cf90fe480e5cea5d1e17db3eb260d657009f79e248a4269d43974d0d8c21b6f54428c9
-  data.tar.gz: 903ad16758edf55aae4d797807df0533d87acc9235e7ab08f388d9e2cfa6ea548807bd38305866bda07c418c1e9dd56e08ad1ffe1a4f25411ce05782fbd82831
+  metadata.gz: 45db13e01d2bd85f40ca9ef2f070a632f9cd5028431a4509ad05084b9a0f5ba9184080eddda29402b2fbe254830f646101c44325d285d2f8c5dfb16f97c5bc54
+  data.tar.gz: 77978113e121bd4d8b47893dc143d54a04b4cc9ad28b79ce77d56d50b570fc7d4d45172d529ac5d550505881c5332887bc1f94685cf8e0ad3ef2daf1d782a043

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 5.101.0 (2026-05-07)
+
+Full Changelog: [v5.100.0...v5.101.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.100.0...v5.101.0)
+
+### Features
+
+* inference: expose chat completions and models under /ai/openai ([4711564](https://github.com/team-telnyx/telnyx-ruby/commit/47115648db8895fabe3913e086b23705c8a1851a))
+
 ## 5.100.0 (2026-05-06)
 
 Full Changelog: [v5.99.0...v5.100.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.99.0...v5.100.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.100.0"
+gem "telnyx", "~> 5.101.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/telnyx/models/ai/chat_create_completion_params.rb

@@ -125,6 +125,21 @@ module Telnyx
         #   @return [Telnyx::Models::AI::ChatCreateCompletionParams::ResponseFormat, nil]
         optional :response_format, -> { Telnyx::AI::ChatCreateCompletionParams::ResponseFormat }
 
+        # @!attribute seed
+        #   If specified, the system will make a best effort to sample deterministically,
+        #   such that repeated requests with the same `seed` and parameters should return
+        #   the same result.
+        #
+        #   @return [Integer, nil]
+        optional :seed, Integer
+
+        # @!attribute stop
+        #   Up to 4 sequences where the API will stop generating further tokens. The
+        #   returned text will not contain the stop sequence.
+        #
+        #   @return [String, Array<String>, nil]
+        optional :stop, union: -> { Telnyx::AI::ChatCreateCompletionParams::Stop }
+
         # @!attribute stream
         #   Whether or not to stream data-only server-sent events as they become available.
         #
@@ -178,7 +193,7 @@ module Telnyx
         #   @return [Boolean, nil]
         optional :use_beam_search, Telnyx::Internal::Type::Boolean
 
-        # @!method initialize(messages:, api_key_ref: nil, best_of: nil, early_stopping: nil, enable_thinking: nil, frequency_penalty: nil, guided_choice: nil, guided_json: nil, guided_regex: nil, length_penalty: nil, logprobs: nil, max_tokens: nil, min_p: nil, model: nil, n: nil, presence_penalty: nil, response_format: nil, stream: nil, temperature: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, use_beam_search: nil, request_options: {})
+        # @!method initialize(messages:, api_key_ref: nil, best_of: nil, early_stopping: nil, enable_thinking: nil, frequency_penalty: nil, guided_choice: nil, guided_json: nil, guided_regex: nil, length_penalty: nil, logprobs: nil, max_tokens: nil, min_p: nil, model: nil, n: nil, presence_penalty: nil, response_format: nil, seed: nil, stop: nil, stream: nil, temperature: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, use_beam_search: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::ChatCreateCompletionParams} for more details.
         #
@@ -216,6 +231,10 @@ module Telnyx
         #
         #   @param response_format [Telnyx::Models::AI::ChatCreateCompletionParams::ResponseFormat] Use this is you want to guarantee a JSON output without defining a schema. For c
         #
+        #   @param seed [Integer] If specified, the system will make a best effort to sample deterministically, su
+        #
+        #   @param stop [String, Array<String>] Up to 4 sequences where the API will stop generating further tokens. The returne
+        #
         #   @param stream [Boolean] Whether or not to stream data-only server-sent events as they become available.
         #
         #   @param temperature [Float] Adjusts the "creativity" of the model. Lower values make the model more determin
@@ -337,6 +356,22 @@ module Telnyx
           end
         end
 
+        # Up to 4 sequences where the API will stop generating further tokens. The
+        # returned text will not contain the stop sequence.
+        module Stop
+          extend Telnyx::Internal::Type::Union
+
+          variant String
+
+          variant -> { Telnyx::Models::AI::ChatCreateCompletionParams::Stop::StringArray }
+
+          # @!method self.variants
+          #   @return [Array(String, Array<String>)]
+
+          # @type [Telnyx::Internal::Type::Converter]
+          StringArray = Telnyx::Internal::Type::ArrayOf[String]
+        end
+
         module ToolChoice
           extend Telnyx::Internal::Type::Enum
 

data/lib/telnyx/models/ai/openai/chat_create_completion_params.rb

@@ -0,0 +1,458 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module OpenAI
+        # @see Telnyx::Resources::AI::OpenAI::Chat#create_completion
+        class ChatCreateCompletionParams < Telnyx::Internal::Type::BaseModel
+          extend Telnyx::Internal::Type::RequestParameters::Converter
+          include Telnyx::Internal::Type::RequestParameters
+
+          # @!attribute messages
+          #   A list of the previous chat messages for context.
+          #
+          #   @return [Array<Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::Message>]
+          required :messages,
+                   -> { Telnyx::Internal::Type::ArrayOf[Telnyx::AI::OpenAI::ChatCreateCompletionParams::Message] }
+
+          # @!attribute api_key_ref
+          #   If you are using an external inference provider like xAI or OpenAI, this field
+          #   allows you to pass along a reference to your API key. After creating an
+          #   [integration secret](https://developers.telnyx.com/api-reference/integration-secrets/create-a-secret)
+          #   for you API key, pass the secret's `identifier` in this field.
+          #
+          #   @return [String, nil]
+          optional :api_key_ref, String
+
+          # @!attribute best_of
+          #   This is used with `use_beam_search` to determine how many candidate beams to
+          #   explore.
+          #
+          #   @return [Integer, nil]
+          optional :best_of, Integer
+
+          # @!attribute early_stopping
+          #   This is used with `use_beam_search`. If `true`, generation stops as soon as
+          #   there are `best_of` complete candidates; if `false`, a heuristic is applied and
+          #   the generation stops when is it very unlikely to find better candidates.
+          #
+          #   @return [Boolean, nil]
+          optional :early_stopping, Telnyx::Internal::Type::Boolean
+
+          # @!attribute enable_thinking
+          #   Whether to enable the thinking/reasoning phase for models that support it (e.g.,
+          #   QwQ, Qwen3). When set to false, the model will skip the internal reasoning step
+          #   and respond directly, which can reduce latency. Defaults to true.
+          #
+          #   @return [Boolean, nil]
+          optional :enable_thinking, Telnyx::Internal::Type::Boolean
+
+          # @!attribute frequency_penalty
+          #   Higher values will penalize the model from repeating the same output tokens.
+          #
+          #   @return [Float, nil]
+          optional :frequency_penalty, Float
+
+          # @!attribute guided_choice
+          #   If specified, the output will be exactly one of the choices.
+          #
+          #   @return [Array<String>, nil]
+          optional :guided_choice, Telnyx::Internal::Type::ArrayOf[String]
+
+          # @!attribute guided_json
+          #   Must be a valid JSON schema. If specified, the output will follow the JSON
+          #   schema.
+          #
+          #   @return [Hash{Symbol=>Object}, nil]
+          optional :guided_json, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+          # @!attribute guided_regex
+          #   If specified, the output will follow the regex pattern.
+          #
+          #   @return [String, nil]
+          optional :guided_regex, String
+
+          # @!attribute length_penalty
+          #   This is used with `use_beam_search` to prefer shorter or longer completions.
+          #
+          #   @return [Float, nil]
+          optional :length_penalty, Float
+
+          # @!attribute logprobs
+          #   Whether to return log probabilities of the output tokens or not. If true,
+          #   returns the log probabilities of each output token returned in the `content` of
+          #   `message`.
+          #
+          #   @return [Boolean, nil]
+          optional :logprobs, Telnyx::Internal::Type::Boolean
+
+          # @!attribute max_tokens
+          #   Maximum number of completion tokens the model should generate.
+          #
+          #   @return [Integer, nil]
+          optional :max_tokens, Integer
+
+          # @!attribute min_p
+          #   This is an alternative to `top_p` that
+          #   [many prefer](https://github.com/huggingface/transformers/issues/27670). Must be
+          #   in [0, 1].
+          #
+          #   @return [Float, nil]
+          optional :min_p, Float
+
+          # @!attribute model
+          #   The language model to chat with.
+          #
+          #   @return [String, nil]
+          optional :model, String
+
+          # @!attribute n
+          #   This will return multiple choices for you instead of a single chat completion.
+          #
+          #   @return [Float, nil]
+          optional :n, Float
+
+          # @!attribute presence_penalty
+          #   Higher values will penalize the model from repeating the same output tokens.
+          #
+          #   @return [Float, nil]
+          optional :presence_penalty, Float
+
+          # @!attribute response_format
+          #   Use this is you want to guarantee a JSON output without defining a schema. For
+          #   control over the schema, use `guided_json`.
+          #
+          #   @return [Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::ResponseFormat, nil]
+          optional :response_format, -> { Telnyx::AI::OpenAI::ChatCreateCompletionParams::ResponseFormat }
+
+          # @!attribute seed
+          #   If specified, the system will make a best effort to sample deterministically,
+          #   such that repeated requests with the same `seed` and parameters should return
+          #   the same result.
+          #
+          #   @return [Integer, nil]
+          optional :seed, Integer
+
+          # @!attribute stop
+          #   Up to 4 sequences where the API will stop generating further tokens. The
+          #   returned text will not contain the stop sequence.
+          #
+          #   @return [String, Array<String>, nil]
+          optional :stop, union: -> { Telnyx::AI::OpenAI::ChatCreateCompletionParams::Stop }
+
+          # @!attribute stream
+          #   Whether or not to stream data-only server-sent events as they become available.
+          #
+          #   @return [Boolean, nil]
+          optional :stream, Telnyx::Internal::Type::Boolean
+
+          # @!attribute temperature
+          #   Adjusts the "creativity" of the model. Lower values make the model more
+          #   deterministic and repetitive, while higher values make the model more random and
+          #   creative.
+          #
+          #   @return [Float, nil]
+          optional :temperature, Float
+
+          # @!attribute tool_choice
+          #
+          #   @return [Symbol, Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::ToolChoice, nil]
+          optional :tool_choice, enum: -> { Telnyx::AI::OpenAI::ChatCreateCompletionParams::ToolChoice }
+
+          # @!attribute tools
+          #   The `function` tool type follows the same schema as the
+          #   [OpenAI Chat Completions API](https://platform.openai.com/docs/api-reference/chat).
+          #   The `retrieval` tool type is unique to Telnyx. You may pass a list of
+          #   [embedded storage buckets](https://developers.telnyx.com/api-reference/embeddings/embed-documents)
+          #   for retrieval-augmented generation.
+          #
+          #   @return [Array<Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::Tool::Function, Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::Tool::Retrieval>, nil]
+          optional :tools,
+                   -> { Telnyx::Internal::Type::ArrayOf[union: Telnyx::AI::OpenAI::ChatCreateCompletionParams::Tool] }
+
+          # @!attribute top_logprobs
+          #   This is used with `logprobs`. An integer between 0 and 20 specifying the number
+          #   of most likely tokens to return at each token position, each with an associated
+          #   log probability.
+          #
+          #   @return [Integer, nil]
+          optional :top_logprobs, Integer
+
+          # @!attribute top_p
+          #   An alternative or complement to `temperature`. This adjusts how many of the top
+          #   possibilities to consider.
+          #
+          #   @return [Float, nil]
+          optional :top_p, Float
+
+          # @!attribute use_beam_search
+          #   Setting this to `true` will allow the model to
+          #   [explore more completion options](https://huggingface.co/blog/how-to-generate#beam-search).
+          #   This is not supported by OpenAI.
+          #
+          #   @return [Boolean, nil]
+          optional :use_beam_search, Telnyx::Internal::Type::Boolean
+
+          # @!method initialize(messages:, api_key_ref: nil, best_of: nil, early_stopping: nil, enable_thinking: nil, frequency_penalty: nil, guided_choice: nil, guided_json: nil, guided_regex: nil, length_penalty: nil, logprobs: nil, max_tokens: nil, min_p: nil, model: nil, n: nil, presence_penalty: nil, response_format: nil, seed: nil, stop: nil, stream: nil, temperature: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, use_beam_search: nil, request_options: {})
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams} for more details.
+          #
+          #   @param messages [Array<Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::Message>] A list of the previous chat messages for context.
+          #
+          #   @param api_key_ref [String] If you are using an external inference provider like xAI or OpenAI, this field a
+          #
+          #   @param best_of [Integer] This is used with `use_beam_search` to determine how many candidate beams to exp
+          #
+          #   @param early_stopping [Boolean] This is used with `use_beam_search`. If `true`, generation stops as soon as ther
+          #
+          #   @param enable_thinking [Boolean] Whether to enable the thinking/reasoning phase for models that support it (e.g.,
+          #
+          #   @param frequency_penalty [Float] Higher values will penalize the model from repeating the same output tokens.
+          #
+          #   @param guided_choice [Array<String>] If specified, the output will be exactly one of the choices.
+          #
+          #   @param guided_json [Hash{Symbol=>Object}] Must be a valid JSON schema. If specified, the output will follow the JSON schem
+          #
+          #   @param guided_regex [String] If specified, the output will follow the regex pattern.
+          #
+          #   @param length_penalty [Float] This is used with `use_beam_search` to prefer shorter or longer completions.
+          #
+          #   @param logprobs [Boolean] Whether to return log probabilities of the output tokens or not. If true, return
+          #
+          #   @param max_tokens [Integer] Maximum number of completion tokens the model should generate.
+          #
+          #   @param min_p [Float] This is an alternative to `top_p` that [many prefer](https://github.com/huggingf
+          #
+          #   @param model [String] The language model to chat with.
+          #
+          #   @param n [Float] This will return multiple choices for you instead of a single chat completion.
+          #
+          #   @param presence_penalty [Float] Higher values will penalize the model from repeating the same output tokens.
+          #
+          #   @param response_format [Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::ResponseFormat] Use this is you want to guarantee a JSON output without defining a schema. For c
+          #
+          #   @param seed [Integer] If specified, the system will make a best effort to sample deterministically, su
+          #
+          #   @param stop [String, Array<String>] Up to 4 sequences where the API will stop generating further tokens. The returne
+          #
+          #   @param stream [Boolean] Whether or not to stream data-only server-sent events as they become available.
+          #
+          #   @param temperature [Float] Adjusts the "creativity" of the model. Lower values make the model more determin
+          #
+          #   @param tool_choice [Symbol, Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::ToolChoice]
+          #
+          #   @param tools [Array<Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::Tool::Function, Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::Tool::Retrieval>] The `function` tool type follows the same schema as the [OpenAI Chat Completions
+          #
+          #   @param top_logprobs [Integer] This is used with `logprobs`. An integer between 0 and 20 specifying the number
+          #
+          #   @param top_p [Float] An alternative or complement to `temperature`. This adjusts how many of the top
+          #
+          #   @param use_beam_search [Boolean] Setting this to `true` will allow the model to [explore more completion options]
+          #
+          #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+
+          class Message < Telnyx::Internal::Type::BaseModel
+            # @!attribute content
+            #
+            #   @return [String, Array<Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::Message::Content::TextAndImageArray>]
+            required :content, union: -> { Telnyx::AI::OpenAI::ChatCreateCompletionParams::Message::Content }
+
+            # @!attribute role
+            #
+            #   @return [Symbol, Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::Message::Role]
+            required :role, enum: -> { Telnyx::AI::OpenAI::ChatCreateCompletionParams::Message::Role }
+
+            # @!method initialize(content:, role:)
+            #   @param content [String, Array<Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::Message::Content::TextAndImageArray>]
+            #   @param role [Symbol, Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::Message::Role]
+
+            # @see Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::Message#content
+            module Content
+              extend Telnyx::Internal::Type::Union
+
+              variant String
+
+              variant -> { Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::Message::Content::TextAndImage2DArray }
+
+              class TextAndImageArray < Telnyx::Internal::Type::BaseModel
+                # @!attribute type
+                #
+                #   @return [Symbol, Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::Message::Content::TextAndImageArray::Type]
+                required :type,
+                         enum: -> { Telnyx::AI::OpenAI::ChatCreateCompletionParams::Message::Content::TextAndImageArray::Type }
+
+                # @!attribute image_url
+                #
+                #   @return [String, nil]
+                optional :image_url, String
+
+                # @!attribute text
+                #
+                #   @return [String, nil]
+                optional :text, String
+
+                # @!method initialize(type:, image_url: nil, text: nil)
+                #   @param type [Symbol, Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::Message::Content::TextAndImageArray::Type]
+                #   @param image_url [String]
+                #   @param text [String]
+
+                # @see Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::Message::Content::TextAndImageArray#type
+                module Type
+                  extend Telnyx::Internal::Type::Enum
+
+                  TEXT = :text
+                  IMAGE_URL = :image_url
+
+                  # @!method self.values
+                  #   @return [Array<Symbol>]
+                end
+              end
+
+              # @!method self.variants
+              #   @return [Array(String, Array<Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::Message::Content::TextAndImageArray>)]
+
+              # @type [Telnyx::Internal::Type::Converter]
+              TextAndImage2DArray =
+                Telnyx::Internal::Type::ArrayOf[-> {
+                  Telnyx::AI::OpenAI::ChatCreateCompletionParams::Message::Content::TextAndImageArray
+                }]
+            end
+
+            # @see Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::Message#role
+            module Role
+              extend Telnyx::Internal::Type::Enum
+
+              SYSTEM = :system
+              USER = :user
+              ASSISTANT = :assistant
+              TOOL = :tool
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+
+          class ResponseFormat < Telnyx::Internal::Type::BaseModel
+            # @!attribute type
+            #
+            #   @return [Symbol, Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::ResponseFormat::Type]
+            required :type, enum: -> { Telnyx::AI::OpenAI::ChatCreateCompletionParams::ResponseFormat::Type }
+
+            # @!method initialize(type:)
+            #   Use this is you want to guarantee a JSON output without defining a schema. For
+            #   control over the schema, use `guided_json`.
+            #
+            #   @param type [Symbol, Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::ResponseFormat::Type]
+
+            # @see Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::ResponseFormat#type
+            module Type
+              extend Telnyx::Internal::Type::Enum
+
+              TEXT = :text
+              JSON_OBJECT = :json_object
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+
+          # Up to 4 sequences where the API will stop generating further tokens. The
+          # returned text will not contain the stop sequence.
+          module Stop
+            extend Telnyx::Internal::Type::Union
+
+            variant String
+
+            variant -> { Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::Stop::StringArray }
+
+            # @!method self.variants
+            #   @return [Array(String, Array<String>)]
+
+            # @type [Telnyx::Internal::Type::Converter]
+            StringArray = Telnyx::Internal::Type::ArrayOf[String]
+          end
+
+          module ToolChoice
+            extend Telnyx::Internal::Type::Enum
+
+            NONE = :none
+            AUTO = :auto
+            REQUIRED = :required
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          module Tool
+            extend Telnyx::Internal::Type::Union
+
+            discriminator :type
+
+            variant :function, -> { Telnyx::AI::OpenAI::ChatCreateCompletionParams::Tool::Function }
+
+            variant :retrieval, -> { Telnyx::AI::OpenAI::ChatCreateCompletionParams::Tool::Retrieval }
+
+            class Function < Telnyx::Internal::Type::BaseModel
+              # @!attribute function
+              #
+              #   @return [Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::Tool::Function::Function]
+              required :function, -> { Telnyx::AI::OpenAI::ChatCreateCompletionParams::Tool::Function::Function }
+
+              # @!attribute type
+              #
+              #   @return [Symbol, :function]
+              required :type, const: :function
+
+              # @!method initialize(function:, type: :function)
+              #   @param function [Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::Tool::Function::Function]
+              #   @param type [Symbol, :function]
+
+              # @see Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::Tool::Function#function
+              class Function < Telnyx::Internal::Type::BaseModel
+                # @!attribute name
+                #
+                #   @return [String]
+                required :name, String
+
+                # @!attribute description
+                #
+                #   @return [String, nil]
+                optional :description, String
+
+                # @!attribute parameters
+                #
+                #   @return [Hash{Symbol=>Object}, nil]
+                optional :parameters, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+                # @!method initialize(name:, description: nil, parameters: nil)
+                #   @param name [String]
+                #   @param description [String]
+                #   @param parameters [Hash{Symbol=>Object}]
+              end
+            end
+
+            class Retrieval < Telnyx::Internal::Type::BaseModel
+              # @!attribute retrieval
+              #
+              #   @return [Telnyx::Models::AI::BucketIDs]
+              required :retrieval, -> { Telnyx::AI::BucketIDs }
+
+              # @!attribute type
+              #
+              #   @return [Symbol, :retrieval]
+              required :type, const: :retrieval
+
+              # @!method initialize(retrieval:, type: :retrieval)
+              #   @param retrieval [Telnyx::Models::AI::BucketIDs]
+              #   @param type [Symbol, :retrieval]
+            end
+
+            # @!method self.variants
+            #   @return [Array(Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::Tool::Function, Telnyx::Models::AI::OpenAI::ChatCreateCompletionParams::Tool::Retrieval)]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/ai/openai/chat_create_completion_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module OpenAI
+        # @type [Telnyx::Internal::Type::Converter]
+        ChatCreateCompletionResponse = Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+      end
+    end
+  end
+end

data/lib/telnyx/models/ai/openai_list_models_params.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # @see Telnyx::Resources::AI::OpenAI#list_models
+      class OpenAIListModelsParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!method initialize(request_options: {})
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/telnyx/models/ai/openai_list_models_response.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # @see Telnyx::Resources::AI::OpenAI#list_models
+      class OpenAIListModelsResponse < Telnyx::Internal::Type::BaseModel
+        # @!attribute data
+        #
+        #   @return [Array<Telnyx::Models::AI::OpenAIListModelsResponse::Data>]
+        required :data, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::Models::AI::OpenAIListModelsResponse::Data] }
+
+        # @!attribute object
+        #
+        #   @return [String, nil]
+        optional :object, String
+
+        # @!method initialize(data:, object: nil)
+        #   @param data [Array<Telnyx::Models::AI::OpenAIListModelsResponse::Data>]
+        #   @param object [String]
+
+        class Data < Telnyx::Internal::Type::BaseModel
+          # @!attribute id
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute created
+          #
+          #   @return [Integer]
+          required :created, Integer
+
+          # @!attribute owned_by
+          #
+          #   @return [String]
+          required :owned_by, String
+
+          # @!attribute object
+          #
+          #   @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]
+        end
+      end
+    end
+  end
+end

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

@@ -5,14 +5,17 @@ module Telnyx
     class AI
       # Generate text with LLMs
       class Chat
+        # @deprecated
+        #
         # Some parameter documentations has been truncated, see
         # {Telnyx::Models::AI::ChatCreateCompletionParams} for more details.
         #
-        # Chat with a language model. This endpoint is consistent with the
+        # **Deprecated**: Use `POST /v2/ai/openai/chat/completions` instead. Chat with a
+        # language model. This endpoint is consistent with the
         # [OpenAI Chat Completions API](https://platform.openai.com/docs/api-reference/chat)
         # and may be used with the OpenAI JS or Python SDK.
         #
-        # @overload create_completion(messages:, api_key_ref: nil, best_of: nil, early_stopping: nil, enable_thinking: nil, frequency_penalty: nil, guided_choice: nil, guided_json: nil, guided_regex: nil, length_penalty: nil, logprobs: nil, max_tokens: nil, min_p: nil, model: nil, n: nil, presence_penalty: nil, response_format: nil, stream: nil, temperature: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, use_beam_search: nil, request_options: {})
+        # @overload create_completion(messages:, api_key_ref: nil, best_of: nil, early_stopping: nil, enable_thinking: nil, frequency_penalty: nil, guided_choice: nil, guided_json: nil, guided_regex: nil, length_penalty: nil, logprobs: nil, max_tokens: nil, min_p: nil, model: nil, n: nil, presence_penalty: nil, response_format: nil, seed: nil, stop: nil, stream: nil, temperature: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, use_beam_search: nil, request_options: {})
         #
         # @param messages [Array<Telnyx::Models::AI::ChatCreateCompletionParams::Message>] A list of the previous chat messages for context.
         #
@@ -48,6 +51,10 @@ module Telnyx
         #
         # @param response_format [Telnyx::Models::AI::ChatCreateCompletionParams::ResponseFormat] Use this is you want to guarantee a JSON output without defining a schema. For c
         #
+        # @param seed [Integer] If specified, the system will make a best effort to sample deterministically, su
+        #
+        # @param stop [String, Array<String>] Up to 4 sequences where the API will stop generating further tokens. The returne
+        #
         # @param stream [Boolean] Whether or not to stream data-only server-sent events as they become available.
         #
         # @param temperature [Float] Adjusts the "creativity" of the model. Lower values make the model more determin