openai 0.71.0 → 0.73.0

data/rbi/openai/models/responses/responses_client_event.rbi

@@ -199,10 +199,7 @@ module OpenAI
         # hit rates. Replaces the `user` field.
         # [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
         sig { returns(T.nilable(String)) }
-        attr_reader :prompt_cache_key
-
-        sig { params(prompt_cache_key: String).void }
-        attr_writer :prompt_cache_key
+        attr_accessor :prompt_cache_key
 
         # Options for prompt caching. Supported for `gpt-5.6` and later models. By
         # default, OpenAI automatically chooses one implicit cache breakpoint. You can add
@@ -273,10 +270,7 @@ module OpenAI
         # identifying information.
         # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
         sig { returns(T.nilable(String)) }
-        attr_reader :safety_identifier
-
-        sig { params(safety_identifier: String).void }
-        attr_writer :safety_identifier
+        attr_accessor :safety_identifier
 
         # Specifies the processing type used for serving the request.
         #
@@ -545,7 +539,7 @@ module OpenAI
             parallel_tool_calls: T.nilable(T::Boolean),
             previous_response_id: T.nilable(String),
             prompt: T.nilable(OpenAI::Responses::ResponsePrompt::OrHash),
-            prompt_cache_key: String,
+            prompt_cache_key: T.nilable(String),
             prompt_cache_options:
               OpenAI::Responses::ResponsesClientEvent::PromptCacheOptions::OrHash,
             prompt_cache_retention:
@@ -553,7 +547,7 @@ module OpenAI
                 OpenAI::Responses::ResponsesClientEvent::PromptCacheRetention::OrSymbol
               ),
             reasoning: T.nilable(OpenAI::Reasoning::OrHash),
-            safety_identifier: String,
+            safety_identifier: T.nilable(String),
             service_tier:
               T.nilable(
                 OpenAI::Responses::ResponsesClientEvent::ServiceTier::OrSymbol
@@ -860,7 +854,7 @@ module OpenAI
               parallel_tool_calls: T.nilable(T::Boolean),
               previous_response_id: T.nilable(String),
               prompt: T.nilable(OpenAI::Responses::ResponsePrompt),
-              prompt_cache_key: String,
+              prompt_cache_key: T.nilable(String),
               prompt_cache_options:
                 OpenAI::Responses::ResponsesClientEvent::PromptCacheOptions,
               prompt_cache_retention:
@@ -868,7 +862,7 @@ module OpenAI
                   OpenAI::Responses::ResponsesClientEvent::PromptCacheRetention::OrSymbol
                 ),
               reasoning: T.nilable(OpenAI::Reasoning),
-              safety_identifier: String,
+              safety_identifier: T.nilable(String),
               service_tier:
                 T.nilable(
                   OpenAI::Responses::ResponsesClientEvent::ServiceTier::OrSymbol

data/rbi/openai/models/webhooks/live_call_incoming_webhook_event.rbi

@@ -0,0 +1,222 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    module Webhooks
+      class LiveCallIncomingWebhookEvent < OpenAI::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              OpenAI::Webhooks::LiveCallIncomingWebhookEvent,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+        # The unique ID of the event.
+        sig { returns(String) }
+        attr_accessor :id
+
+        # The Unix timestamp (in seconds) of when the event was created.
+        sig { returns(Integer) }
+        attr_accessor :created_at
+
+        # Event data payload.
+        sig { returns(OpenAI::Webhooks::LiveCallIncomingWebhookEvent::Data) }
+        attr_reader :data
+
+        sig do
+          params(
+            data: OpenAI::Webhooks::LiveCallIncomingWebhookEvent::Data::OrHash
+          ).void
+        end
+        attr_writer :data
+
+        # The type of the event. Always `live.call.incoming`.
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # The object of the event. Always `event`.
+        sig do
+          returns(
+            T.nilable(
+              OpenAI::Webhooks::LiveCallIncomingWebhookEvent::Object::TaggedSymbol
+            )
+          )
+        end
+        attr_reader :object
+
+        sig do
+          params(
+            object:
+              OpenAI::Webhooks::LiveCallIncomingWebhookEvent::Object::OrSymbol
+          ).void
+        end
+        attr_writer :object
+
+        # Sent when an incoming API SIP session is available for Live acceptance. The same
+        # pending session can also emit `realtime.call.incoming`; the first successful
+        # Realtime or Live accept endpoint selects the runtime surface.
+        sig do
+          params(
+            id: String,
+            created_at: Integer,
+            data: OpenAI::Webhooks::LiveCallIncomingWebhookEvent::Data::OrHash,
+            object:
+              OpenAI::Webhooks::LiveCallIncomingWebhookEvent::Object::OrSymbol,
+            type: Symbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The unique ID of the event.
+          id:,
+          # The Unix timestamp (in seconds) of when the event was created.
+          created_at:,
+          # Event data payload.
+          data:,
+          # The object of the event. Always `event`.
+          object: nil,
+          # The type of the event. Always `live.call.incoming`.
+          type: :"live.call.incoming"
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              created_at: Integer,
+              data: OpenAI::Webhooks::LiveCallIncomingWebhookEvent::Data,
+              type: Symbol,
+              object:
+                OpenAI::Webhooks::LiveCallIncomingWebhookEvent::Object::TaggedSymbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class Data < OpenAI::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                OpenAI::Webhooks::LiveCallIncomingWebhookEvent::Data,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+          # The Transceiver `rtc_...` ID of the pending SIP session. The same value appears
+          # as `call_id` in `realtime.call.incoming`.
+          sig { returns(String) }
+          attr_accessor :session_id
+
+          # Headers from the SIP Invite.
+          sig do
+            returns(
+              T::Array[
+                OpenAI::Webhooks::LiveCallIncomingWebhookEvent::Data::SipHeader
+              ]
+            )
+          end
+          attr_accessor :sip_headers
+
+          # Event data payload.
+          sig do
+            params(
+              session_id: String,
+              sip_headers:
+                T::Array[
+                  OpenAI::Webhooks::LiveCallIncomingWebhookEvent::Data::SipHeader::OrHash
+                ]
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # The Transceiver `rtc_...` ID of the pending SIP session. The same value appears
+            # as `call_id` in `realtime.call.incoming`.
+            session_id:,
+            # Headers from the SIP Invite.
+            sip_headers:
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                session_id: String,
+                sip_headers:
+                  T::Array[
+                    OpenAI::Webhooks::LiveCallIncomingWebhookEvent::Data::SipHeader
+                  ]
+              }
+            )
+          end
+          def to_hash
+          end
+
+          class SipHeader < OpenAI::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  OpenAI::Webhooks::LiveCallIncomingWebhookEvent::Data::SipHeader,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+            # Name of the SIP Header.
+            sig { returns(String) }
+            attr_accessor :name
+
+            # Value of the SIP Header.
+            sig { returns(String) }
+            attr_accessor :value
+
+            # A header from the SIP Invite.
+            sig do
+              params(name: String, value: String).returns(T.attached_class)
+            end
+            def self.new(
+              # Name of the SIP Header.
+              name:,
+              # Value of the SIP Header.
+              value:
+            )
+            end
+
+            sig { override.returns({ name: String, value: String }) }
+            def to_hash
+            end
+          end
+        end
+
+        # The object of the event. Always `event`.
+        module Object
+          extend OpenAI::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                OpenAI::Webhooks::LiveCallIncomingWebhookEvent::Object
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          EVENT =
+            T.let(
+              :event,
+              OpenAI::Webhooks::LiveCallIncomingWebhookEvent::Object::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                OpenAI::Webhooks::LiveCallIncomingWebhookEvent::Object::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/openai/models/webhooks/realtime_call_incoming_webhook_event.rbi

@@ -56,7 +56,9 @@ module OpenAI
         end
         attr_writer :object
 
-        # Sent when Realtime API Receives a incoming SIP call.
+        # Sent when an incoming API SIP session is available for Realtime acceptance. The
+        # same pending session can also emit `live.call.incoming`; the first successful
+        # Realtime or Live accept endpoint selects the runtime surface.
         sig do
           params(
             id: String,
@@ -106,7 +108,8 @@ module OpenAI
               )
             end
 
-          # The unique ID of this call.
+          # The Transceiver `rtc_...` ID of the pending SIP session. The same value appears
+          # as `session_id` in `live.call.incoming`.
           sig { returns(String) }
           attr_accessor :call_id
 
@@ -131,7 +134,8 @@ module OpenAI
             ).returns(T.attached_class)
           end
           def self.new(
-            # The unique ID of this call.
+            # The Transceiver `rtc_...` ID of the pending SIP session. The same value appears
+            # as `session_id` in `live.call.incoming`.
             call_id:,
             # Headers from the SIP Invite.
             sip_headers:

data/rbi/openai/models/webhooks/unwrap_webhook_event.rbi

@@ -20,6 +20,7 @@ module OpenAI
               OpenAI::Webhooks::FineTuningJobCancelledWebhookEvent,
               OpenAI::Webhooks::FineTuningJobFailedWebhookEvent,
               OpenAI::Webhooks::FineTuningJobSucceededWebhookEvent,
+              OpenAI::Webhooks::LiveCallIncomingWebhookEvent,
               OpenAI::Webhooks::RealtimeCallIncomingWebhookEvent,
               OpenAI::Webhooks::ResponseCancelledWebhookEvent,
               OpenAI::Webhooks::ResponseCompletedWebhookEvent,

data/rbi/openai/resources/admin/organization/projects/spend_limit.rbi

@@ -0,0 +1,78 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+    class Admin
+      class Organization
+        class Projects
+          class SpendLimit
+            # Get a project's hard spend limit.
+            sig do
+              params(
+                project_id: String,
+                request_options: OpenAI::RequestOptions::OrHash
+              ).returns(
+                OpenAI::Admin::Organization::Projects::ProjectSpendLimit
+              )
+            end
+            def retrieve(
+              # The ID of the project whose hard spend limit is being managed.
+              project_id,
+              request_options: {}
+            )
+            end
+
+            # Create or replace a project's hard spend limit.
+            sig do
+              params(
+                project_id: String,
+                currency:
+                  OpenAI::Admin::Organization::Projects::SpendLimitUpdateParams::Currency::OrSymbol,
+                interval:
+                  OpenAI::Admin::Organization::Projects::SpendLimitUpdateParams::Interval::OrSymbol,
+                threshold_amount: Integer,
+                request_options: OpenAI::RequestOptions::OrHash
+              ).returns(
+                OpenAI::Admin::Organization::Projects::ProjectSpendLimit
+              )
+            end
+            def update(
+              # The ID of the project whose hard spend limit is being managed.
+              project_id,
+              # The currency for the threshold amount. Currently, only `USD` is supported.
+              currency:,
+              # The time interval for evaluating spend against the threshold. Currently, only
+              # `month` is supported.
+              interval:,
+              # The hard spend limit amount, in cents.
+              threshold_amount:,
+              request_options: {}
+            )
+            end
+
+            # Delete a project's hard spend limit.
+            sig do
+              params(
+                project_id: String,
+                request_options: OpenAI::RequestOptions::OrHash
+              ).returns(
+                OpenAI::Admin::Organization::Projects::ProjectSpendLimitDeleted
+              )
+            end
+            def delete(
+              # The ID of the project whose hard spend limit is being managed.
+              project_id,
+              request_options: {}
+            )
+            end
+
+            # @api private
+            sig { params(client: OpenAI::Client).returns(T.attached_class) }
+            def self.new(client:)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/openai/resources/admin/organization/projects.rbi

@@ -60,6 +60,13 @@ module OpenAI
           end
           attr_reader :data_retention
 
+          sig do
+            returns(
+              OpenAI::Resources::Admin::Organization::Projects::SpendLimit
+            )
+          end
+          attr_reader :spend_limit
+
           sig do
             returns(
               OpenAI::Resources::Admin::Organization::Projects::SpendAlerts

data/rbi/openai/resources/admin/organization/spend_limit.rbi

@@ -0,0 +1,57 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+    class Admin
+      class Organization
+        class SpendLimit
+          # Get the organization's hard spend limit.
+          sig do
+            params(request_options: OpenAI::RequestOptions::OrHash).returns(
+              OpenAI::Admin::Organization::OrganizationSpendLimit
+            )
+          end
+          def retrieve(request_options: {})
+          end
+
+          # Create or replace the organization's hard spend limit.
+          sig do
+            params(
+              currency:
+                OpenAI::Admin::Organization::SpendLimitUpdateParams::Currency::OrSymbol,
+              interval:
+                OpenAI::Admin::Organization::SpendLimitUpdateParams::Interval::OrSymbol,
+              threshold_amount: Integer,
+              request_options: OpenAI::RequestOptions::OrHash
+            ).returns(OpenAI::Admin::Organization::OrganizationSpendLimit)
+          end
+          def update(
+            # The currency for the threshold amount. Currently, only `USD` is supported.
+            currency:,
+            # The time interval for evaluating spend against the threshold. Currently, only
+            # `month` is supported.
+            interval:,
+            # The hard spend limit amount, in cents.
+            threshold_amount:,
+            request_options: {}
+          )
+          end
+
+          # Delete the organization's hard spend limit.
+          sig do
+            params(request_options: OpenAI::RequestOptions::OrHash).returns(
+              OpenAI::Admin::Organization::OrganizationSpendLimitDeleted
+            )
+          end
+          def delete(request_options: {})
+          end
+
+          # @api private
+          sig { params(client: OpenAI::Client).returns(T.attached_class) }
+          def self.new(client:)
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/openai/resources/admin/organization.rbi

@@ -29,6 +29,9 @@ module OpenAI
         sig { returns(OpenAI::Resources::Admin::Organization::DataRetention) }
         attr_reader :data_retention
 
+        sig { returns(OpenAI::Resources::Admin::Organization::SpendLimit) }
+        attr_reader :spend_limit
+
         sig { returns(OpenAI::Resources::Admin::Organization::SpendAlerts) }
         attr_reader :spend_alerts
 

data/rbi/openai/resources/audio/transcriptions.rbi

@@ -24,9 +24,11 @@ module OpenAI
                 )
               ),
             include: T::Array[OpenAI::Audio::TranscriptionInclude::OrSymbol],
+            keywords: T::Array[String],
             known_speaker_names: T::Array[String],
             known_speaker_references: T::Array[String],
             language: String,
+            languages: T::Array[String],
             prompt: String,
             response_format: OpenAI::AudioResponseFormat::OrSymbol,
             temperature: Float,
@@ -44,7 +46,7 @@ module OpenAI
           # The audio file object (not file name) to transcribe, in one of these formats:
           # flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, or webm.
           file:,
-          # ID of the model to use. The options are `gpt-4o-transcribe`,
+          # ID of the model to use. The options are `gpt-transcribe`, `gpt-4o-transcribe`,
           # `gpt-4o-mini-transcribe`, `gpt-4o-mini-transcribe-2025-12-15`, `whisper-1`
           # (which is powered by our open source Whisper V2 model), and
           # `gpt-4o-transcribe-diarize`.
@@ -63,6 +65,9 @@ module OpenAI
           # `gpt-4o-mini-transcribe`, and `gpt-4o-mini-transcribe-2025-12-15`. This field is
           # not supported when using `gpt-4o-transcribe-diarize`.
           include: nil,
+          # Words or phrases to guide transcription of the input audio. Supported by
+          # `gpt-transcribe`.
+          keywords: nil,
           # Optional list of speaker names that correspond to the audio samples provided in
           # `known_speaker_references[]`. Each entry should be a short identifier (for
           # example `customer` or `agent`). Up to 4 speakers are supported.
@@ -77,6 +82,10 @@ module OpenAI
           # [ISO-639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) (e.g. `en`)
           # format will improve accuracy and latency.
           language: nil,
+          # Possible languages of the input audio, in
+          # [ISO-639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) format.
+          # Supported by `gpt-transcribe`.
+          languages: nil,
           # An optional text to guide the model's style or continue a previous audio
           # segment. The
           # [prompt](https://platform.openai.com/docs/guides/speech-to-text#prompting)
@@ -128,9 +137,11 @@ module OpenAI
                 )
               ),
             include: T::Array[OpenAI::Audio::TranscriptionInclude::OrSymbol],
+            keywords: T::Array[String],
             known_speaker_names: T::Array[String],
             known_speaker_references: T::Array[String],
             language: String,
+            languages: T::Array[String],
             prompt: String,
             response_format: OpenAI::AudioResponseFormat::OrSymbol,
             temperature: Float,
@@ -150,7 +161,7 @@ module OpenAI
           # The audio file object (not file name) to transcribe, in one of these formats:
           # flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, or webm.
           file:,
-          # ID of the model to use. The options are `gpt-4o-transcribe`,
+          # ID of the model to use. The options are `gpt-transcribe`, `gpt-4o-transcribe`,
           # `gpt-4o-mini-transcribe`, `gpt-4o-mini-transcribe-2025-12-15`, `whisper-1`
           # (which is powered by our open source Whisper V2 model), and
           # `gpt-4o-transcribe-diarize`.
@@ -169,6 +180,9 @@ module OpenAI
           # `gpt-4o-mini-transcribe`, and `gpt-4o-mini-transcribe-2025-12-15`. This field is
           # not supported when using `gpt-4o-transcribe-diarize`.
           include: nil,
+          # Words or phrases to guide transcription of the input audio. Supported by
+          # `gpt-transcribe`.
+          keywords: nil,
           # Optional list of speaker names that correspond to the audio samples provided in
           # `known_speaker_references[]`. Each entry should be a short identifier (for
           # example `customer` or `agent`). Up to 4 speakers are supported.
@@ -183,6 +197,10 @@ module OpenAI
           # [ISO-639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) (e.g. `en`)
           # format will improve accuracy and latency.
           language: nil,
+          # Possible languages of the input audio, in
+          # [ISO-639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) format.
+          # Supported by `gpt-transcribe`.
+          languages: nil,
           # An optional text to guide the model's style or continue a previous audio
           # segment. The
           # [prompt](https://platform.openai.com/docs/guides/speech-to-text#prompting)

data/rbi/openai/resources/beta/responses.rbi

@@ -60,7 +60,7 @@ module OpenAI
             parallel_tool_calls: T.nilable(T::Boolean),
             previous_response_id: T.nilable(String),
             prompt: T.nilable(OpenAI::Beta::BetaResponsePrompt::OrHash),
-            prompt_cache_key: String,
+            prompt_cache_key: T.nilable(String),
             prompt_cache_options:
               OpenAI::Beta::ResponseCreateParams::PromptCacheOptions::OrHash,
             prompt_cache_retention:
@@ -69,7 +69,7 @@ module OpenAI
               ),
             reasoning:
               T.nilable(OpenAI::Beta::ResponseCreateParams::Reasoning::OrHash),
-            safety_identifier: String,
+            safety_identifier: T.nilable(String),
             service_tier:
               T.nilable(
                 OpenAI::Beta::ResponseCreateParams::ServiceTier::OrSymbol
@@ -399,7 +399,7 @@ module OpenAI
             parallel_tool_calls: T.nilable(T::Boolean),
             previous_response_id: T.nilable(String),
             prompt: T.nilable(OpenAI::Beta::BetaResponsePrompt::OrHash),
-            prompt_cache_key: String,
+            prompt_cache_key: T.nilable(String),
             prompt_cache_options:
               OpenAI::Beta::ResponseCreateParams::PromptCacheOptions::OrHash,
             prompt_cache_retention:
@@ -408,7 +408,7 @@ module OpenAI
               ),
             reasoning:
               T.nilable(OpenAI::Beta::ResponseCreateParams::Reasoning::OrHash),
-            safety_identifier: String,
+            safety_identifier: T.nilable(String),
             service_tier:
               T.nilable(
                 OpenAI::Beta::ResponseCreateParams::ServiceTier::OrSymbol

data/rbi/openai/resources/chat/completions.rbi

@@ -76,7 +76,7 @@ module OpenAI
             prediction:
               T.nilable(OpenAI::Chat::ChatCompletionPredictionContent::OrHash),
             presence_penalty: T.nilable(Float),
-            prompt_cache_key: String,
+            prompt_cache_key: T.nilable(String),
             prompt_cache_options:
               OpenAI::Chat::CompletionCreateParams::PromptCacheOptions::OrHash,
             prompt_cache_retention:
@@ -91,7 +91,7 @@ module OpenAI
                 OpenAI::StructuredOutput::JsonSchemaConverter,
                 OpenAI::ResponseFormatJSONObject::OrHash
               ),
-            safety_identifier: String,
+            safety_identifier: T.nilable(String),
             seed: T.nilable(Integer),
             service_tier:
               T.nilable(
@@ -363,7 +363,8 @@ module OpenAI
           user: nil,
           # Constrains the verbosity of the model's response. Lower values will result in
           # more concise responses, while higher values will result in more verbose
-          # responses. Currently supported values are `low`, `medium`, and `high`.
+          # responses. Currently supported values are `low`, `medium`, and `high`. The
+          # default is `medium`.
           verbosity: nil,
           # This tool searches the web for relevant results to use in a response. Learn more
           # about the
@@ -441,7 +442,7 @@ module OpenAI
             prediction:
               T.nilable(OpenAI::Chat::ChatCompletionPredictionContent::OrHash),
             presence_penalty: T.nilable(Float),
-            prompt_cache_key: String,
+            prompt_cache_key: T.nilable(String),
             prompt_cache_options:
               OpenAI::Chat::CompletionCreateParams::PromptCacheOptions::OrHash,
             prompt_cache_retention:
@@ -455,7 +456,7 @@ module OpenAI
                 OpenAI::ResponseFormatJSONSchema::OrHash,
                 OpenAI::ResponseFormatJSONObject::OrHash
               ),
-            safety_identifier: String,
+            safety_identifier: T.nilable(String),
             seed: T.nilable(Integer),
             service_tier:
               T.nilable(
@@ -726,7 +727,8 @@ module OpenAI
           user: nil,
           # Constrains the verbosity of the model's response. Lower values will result in
           # more concise responses, while higher values will result in more verbose
-          # responses. Currently supported values are `low`, `medium`, and `high`.
+          # responses. Currently supported values are `low`, `medium`, and `high`. The
+          # default is `medium`.
           verbosity: nil,
           # This tool searches the web for relevant results to use in a response. Learn more
           # about the