openai 0.70.0 → 0.72.0

data/lib/openai/resources/admin/organization/projects.rb

@@ -32,6 +32,9 @@ module OpenAI
           # @return [OpenAI::Resources::Admin::Organization::Projects::DataRetention]
           attr_reader :data_retention
 
+          # @return [OpenAI::Resources::Admin::Organization::Projects::SpendLimit]
+          attr_reader :spend_limit
+
           # @return [OpenAI::Resources::Admin::Organization::Projects::SpendAlerts]
           attr_reader :spend_alerts
 
@@ -189,6 +192,7 @@ module OpenAI
             @groups = OpenAI::Resources::Admin::Organization::Projects::Groups.new(client: client)
             @roles = OpenAI::Resources::Admin::Organization::Projects::Roles.new(client: client)
             @data_retention = OpenAI::Resources::Admin::Organization::Projects::DataRetention.new(client: client)
+            @spend_limit = OpenAI::Resources::Admin::Organization::Projects::SpendLimit.new(client: client)
             @spend_alerts = OpenAI::Resources::Admin::Organization::Projects::SpendAlerts.new(client: client)
             @certificates = OpenAI::Resources::Admin::Organization::Projects::Certificates.new(client: client)
           end

data/lib/openai/resources/admin/organization/spend_limit.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Admin
+      class Organization
+        class SpendLimit
+          # Get the organization's hard spend limit.
+          #
+          # @overload retrieve(request_options: {})
+          #
+          # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [OpenAI::Models::Admin::Organization::OrganizationSpendLimit]
+          #
+          # @see OpenAI::Models::Admin::Organization::SpendLimitRetrieveParams
+          def retrieve(params = {})
+            @client.request(
+              method: :get,
+              path: "organization/spend_limit",
+              model: OpenAI::Admin::Organization::OrganizationSpendLimit,
+              security: {admin_api_key_auth: true},
+              options: params[:request_options]
+            )
+          end
+
+          # Some parameter documentations has been truncated, see
+          # {OpenAI::Models::Admin::Organization::SpendLimitUpdateParams} for more details.
+          #
+          # Create or replace the organization's hard spend limit.
+          #
+          # @overload update(currency:, interval:, threshold_amount:, request_options: {})
+          #
+          # @param currency [Symbol, OpenAI::Models::Admin::Organization::SpendLimitUpdateParams::Currency] The currency for the threshold amount. Currently, only `USD` is supported.
+          #
+          # @param interval [Symbol, OpenAI::Models::Admin::Organization::SpendLimitUpdateParams::Interval] The time interval for evaluating spend against the threshold. Currently, only `m
+          #
+          # @param threshold_amount [Integer] The hard spend limit amount, in cents.
+          #
+          # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [OpenAI::Models::Admin::Organization::OrganizationSpendLimit]
+          #
+          # @see OpenAI::Models::Admin::Organization::SpendLimitUpdateParams
+          def update(params)
+            parsed, options = OpenAI::Admin::Organization::SpendLimitUpdateParams.dump_request(params)
+            @client.request(
+              method: :post,
+              path: "organization/spend_limit",
+              body: parsed,
+              model: OpenAI::Admin::Organization::OrganizationSpendLimit,
+              security: {admin_api_key_auth: true},
+              options: options
+            )
+          end
+
+          # Delete the organization's hard spend limit.
+          #
+          # @overload delete(request_options: {})
+          #
+          # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [OpenAI::Models::Admin::Organization::OrganizationSpendLimitDeleted]
+          #
+          # @see OpenAI::Models::Admin::Organization::SpendLimitDeleteParams
+          def delete(params = {})
+            @client.request(
+              method: :delete,
+              path: "organization/spend_limit",
+              model: OpenAI::Admin::Organization::OrganizationSpendLimitDeleted,
+              security: {admin_api_key_auth: true},
+              options: params[:request_options]
+            )
+          end
+
+          # @api private
+          #
+          # @param client [OpenAI::Client]
+          def initialize(client:)
+            @client = client
+          end
+        end
+      end
+    end
+  end
+end

data/lib/openai/resources/admin/organization.rb

@@ -29,6 +29,9 @@ module OpenAI
         # @return [OpenAI::Resources::Admin::Organization::DataRetention]
         attr_reader :data_retention
 
+        # @return [OpenAI::Resources::Admin::Organization::SpendLimit]
+        attr_reader :spend_limit
+
         # @return [OpenAI::Resources::Admin::Organization::SpendAlerts]
         attr_reader :spend_alerts
 
@@ -51,6 +54,7 @@ module OpenAI
           @groups = OpenAI::Resources::Admin::Organization::Groups.new(client: client)
           @roles = OpenAI::Resources::Admin::Organization::Roles.new(client: client)
           @data_retention = OpenAI::Resources::Admin::Organization::DataRetention.new(client: client)
+          @spend_limit = OpenAI::Resources::Admin::Organization::SpendLimit.new(client: client)
           @spend_alerts = OpenAI::Resources::Admin::Organization::SpendAlerts.new(client: client)
           @certificates = OpenAI::Resources::Admin::Organization::Certificates.new(client: client)
           @projects = OpenAI::Resources::Admin::Organization::Projects.new(client: client)

data/lib/openai/resources/beta/responses.rb

@@ -59,7 +59,7 @@ module OpenAI
         #
         # @param prompt [OpenAI::Models::Beta::BetaResponsePrompt, nil] Body param: Reference to a prompt template and its variables.
         #
-        # @param prompt_cache_key [String] Body param: Used by OpenAI to cache responses for similar requests to optimize y
+        # @param prompt_cache_key [String, nil] Body param: Used by OpenAI to cache responses for similar requests to optimize y
         #
         # @param prompt_cache_options [OpenAI::Models::Beta::ResponseCreateParams::PromptCacheOptions] Body param: Options for prompt caching. Supported for `gpt-5.6` and later models
         #
@@ -67,7 +67,7 @@ module OpenAI
         #
         # @param reasoning [OpenAI::Models::Beta::ResponseCreateParams::Reasoning, nil] Body param: **gpt-5 and o-series models only**
         #
-        # @param safety_identifier [String] Body param: A stable identifier used to help detect users of your application th
+        # @param safety_identifier [String, nil] Body param: A stable identifier used to help detect users of your application th
         #
         # @param service_tier [Symbol, OpenAI::Models::Beta::ResponseCreateParams::ServiceTier, nil] Body param: Specifies the processing type used for serving the request.
         #
@@ -165,7 +165,7 @@ module OpenAI
         #
         # @param prompt [OpenAI::Models::Beta::BetaResponsePrompt, nil] Body param: Reference to a prompt template and its variables.
         #
-        # @param prompt_cache_key [String] Body param: Used by OpenAI to cache responses for similar requests to optimize y
+        # @param prompt_cache_key [String, nil] Body param: Used by OpenAI to cache responses for similar requests to optimize y
         #
         # @param prompt_cache_options [OpenAI::Models::Beta::ResponseCreateParams::PromptCacheOptions] Body param: Options for prompt caching. Supported for `gpt-5.6` and later models
         #
@@ -173,7 +173,7 @@ module OpenAI
         #
         # @param reasoning [OpenAI::Models::Beta::ResponseCreateParams::Reasoning, nil] Body param: **gpt-5 and o-series models only**
         #
-        # @param safety_identifier [String] Body param: A stable identifier used to help detect users of your application th
+        # @param safety_identifier [String, nil] Body param: A stable identifier used to help detect users of your application th
         #
         # @param service_tier [Symbol, OpenAI::Models::Beta::ResponseCreateParams::ServiceTier, nil] Body param: Specifies the processing type used for serving the request.
         #

data/lib/openai/resources/chat/completions.rb

@@ -73,7 +73,7 @@ module OpenAI
         #
         # @param presence_penalty [Float, nil] Number between -2.0 and 2.0. Positive values penalize new tokens based on
         #
-        # @param prompt_cache_key [String] Used by OpenAI to cache responses for similar requests to optimize your cache hi
+        # @param prompt_cache_key [String, nil] Used by OpenAI to cache responses for similar requests to optimize your cache hi
         #
         # @param prompt_cache_options [OpenAI::Models::Chat::CompletionCreateParams::PromptCacheOptions] Options for prompt caching. Supported for `gpt-5.6` and later models. By default
         #
@@ -83,7 +83,7 @@ module OpenAI
         #
         # @param response_format [OpenAI::Models::ResponseFormatText, OpenAI::Models::ResponseFormatJSONSchema, OpenAI::Models::ResponseFormatJSONObject] An object specifying the format that the model must output.
         #
-        # @param safety_identifier [String] A stable identifier used to help detect users of your application that may be vi
+        # @param safety_identifier [String, nil] A stable identifier used to help detect users of your application that may be vi
         #
         # @param seed [Integer, nil] This feature is in Beta.
         #
@@ -329,7 +329,7 @@ module OpenAI
         #
         # @param presence_penalty [Float, nil] Number between -2.0 and 2.0. Positive values penalize new tokens based on
         #
-        # @param prompt_cache_key [String] Used by OpenAI to cache responses for similar requests to optimize your cache hi
+        # @param prompt_cache_key [String, nil] Used by OpenAI to cache responses for similar requests to optimize your cache hi
         #
         # @param prompt_cache_options [OpenAI::Models::Chat::CompletionCreateParams::PromptCacheOptions] Options for prompt caching. Supported for `gpt-5.6` and later models. By default
         #
@@ -339,7 +339,7 @@ module OpenAI
         #
         # @param response_format [OpenAI::Models::ResponseFormatText, OpenAI::Models::ResponseFormatJSONSchema, OpenAI::Models::ResponseFormatJSONObject] An object specifying the format that the model must output.
         #
-        # @param safety_identifier [String] A stable identifier used to help detect users of your application that may be vi
+        # @param safety_identifier [String, nil] A stable identifier used to help detect users of your application that may be vi
         #
         # @param seed [Integer, nil] This feature is in Beta.
         #

data/lib/openai/resources/responses.rb

@@ -56,7 +56,7 @@ module OpenAI
       #
       # @param prompt [OpenAI::Models::Responses::ResponsePrompt, nil] Reference to a prompt template and its variables.
       #
-      # @param prompt_cache_key [String] Used by OpenAI to cache responses for similar requests to optimize your cache hi
+      # @param prompt_cache_key [String, nil] Used by OpenAI to cache responses for similar requests to optimize your cache hi
       #
       # @param prompt_cache_options [OpenAI::Models::Responses::ResponseCreateParams::PromptCacheOptions] Options for prompt caching. Supported for `gpt-5.6` and later models. By default
       #
@@ -64,7 +64,7 @@ module OpenAI
       #
       # @param reasoning [OpenAI::Models::Reasoning, nil] **gpt-5 and o-series models only**
       #
-      # @param safety_identifier [String] A stable identifier used to help detect users of your application that may be vi
+      # @param safety_identifier [String, nil] A stable identifier used to help detect users of your application that may be vi
       #
       # @param service_tier [Symbol, OpenAI::Models::Responses::ResponseCreateParams::ServiceTier, nil] Specifies the processing type used for serving the request.
       #
@@ -287,7 +287,7 @@ module OpenAI
       #
       # @param prompt [OpenAI::Models::Responses::ResponsePrompt, nil] Reference to a prompt template and its variables.
       #
-      # @param prompt_cache_key [String] Used by OpenAI to cache responses for similar requests to optimize your cache hi
+      # @param prompt_cache_key [String, nil] Used by OpenAI to cache responses for similar requests to optimize your cache hi
       #
       # @param prompt_cache_options [OpenAI::Models::Responses::ResponseCreateParams::PromptCacheOptions] Options for prompt caching. Supported for `gpt-5.6` and later models. By default
       #
@@ -295,7 +295,7 @@ module OpenAI
       #
       # @param reasoning [OpenAI::Models::Reasoning, nil] **gpt-5 and o-series models only**
       #
-      # @param safety_identifier [String] A stable identifier used to help detect users of your application that may be vi
+      # @param safety_identifier [String, nil] A stable identifier used to help detect users of your application that may be vi
       #
       # @param service_tier [Symbol, OpenAI::Models::Responses::ResponseCreateParams::ServiceTier, nil] Specifies the processing type used for serving the request.
       #

data/lib/openai/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OpenAI
-  VERSION = "0.70.0"
+  VERSION = "0.72.0"
 end

data/lib/openai.rb

@@ -53,6 +53,9 @@ require_relative "openai/internal"
 require_relative "openai/request_options"
 require_relative "openai/file_part"
 require_relative "openai/errors"
+require_relative "openai/provider"
+require_relative "openai/internal/provider"
+require_relative "openai/providers/bedrock"
 require_relative "openai/internal/transport/base_client"
 require_relative "openai/internal/transport/pooled_net_requester"
 require_relative "openai/client"
@@ -144,6 +147,8 @@ require_relative "openai/models/admin/organization/invite_retrieve_params"
 require_relative "openai/models/admin/organization/organization_data_retention"
 require_relative "openai/models/admin/organization/organization_spend_alert"
 require_relative "openai/models/admin/organization/organization_spend_alert_deleted"
+require_relative "openai/models/admin/organization/organization_spend_limit"
+require_relative "openai/models/admin/organization/organization_spend_limit_deleted"
 require_relative "openai/models/admin/organization/organization_user"
 require_relative "openai/models/admin/organization/project"
 require_relative "openai/models/admin/organization/project_archive_params"
@@ -190,6 +195,8 @@ require_relative "openai/models/admin/organization/projects/project_rate_limit"
 require_relative "openai/models/admin/organization/projects/project_service_account"
 require_relative "openai/models/admin/organization/projects/project_spend_alert"
 require_relative "openai/models/admin/organization/projects/project_spend_alert_deleted"
+require_relative "openai/models/admin/organization/projects/project_spend_limit"
+require_relative "openai/models/admin/organization/projects/project_spend_limit_deleted"
 require_relative "openai/models/admin/organization/projects/project_user"
 require_relative "openai/models/admin/organization/projects/rate_limit_list_rate_limits_params"
 require_relative "openai/models/admin/organization/projects/rate_limit_update_rate_limit_params"
@@ -205,12 +212,17 @@ require_relative "openai/models/admin/organization/projects/service_account_dele
 require_relative "openai/models/admin/organization/projects/service_account_delete_response"
 require_relative "openai/models/admin/organization/projects/service_account_list_params"
 require_relative "openai/models/admin/organization/projects/service_account_retrieve_params"
+require_relative "openai/models/admin/organization/projects/service_accounts/api_key_create_params"
+require_relative "openai/models/admin/organization/projects/service_accounts/api_key_create_response"
 require_relative "openai/models/admin/organization/projects/service_account_update_params"
 require_relative "openai/models/admin/organization/projects/spend_alert_create_params"
 require_relative "openai/models/admin/organization/projects/spend_alert_delete_params"
 require_relative "openai/models/admin/organization/projects/spend_alert_list_params"
 require_relative "openai/models/admin/organization/projects/spend_alert_retrieve_params"
 require_relative "openai/models/admin/organization/projects/spend_alert_update_params"
+require_relative "openai/models/admin/organization/projects/spend_limit_delete_params"
+require_relative "openai/models/admin/organization/projects/spend_limit_retrieve_params"
+require_relative "openai/models/admin/organization/projects/spend_limit_update_params"
 require_relative "openai/models/admin/organization/projects/user_create_params"
 require_relative "openai/models/admin/organization/projects/user_delete_params"
 require_relative "openai/models/admin/organization/projects/user_delete_response"
@@ -238,6 +250,9 @@ require_relative "openai/models/admin/organization/spend_alert_delete_params"
 require_relative "openai/models/admin/organization/spend_alert_list_params"
 require_relative "openai/models/admin/organization/spend_alert_retrieve_params"
 require_relative "openai/models/admin/organization/spend_alert_update_params"
+require_relative "openai/models/admin/organization/spend_limit_delete_params"
+require_relative "openai/models/admin/organization/spend_limit_retrieve_params"
+require_relative "openai/models/admin/organization/spend_limit_update_params"
 require_relative "openai/models/admin/organization/usage_audio_speeches_params"
 require_relative "openai/models/admin/organization/usage_audio_speeches_response"
 require_relative "openai/models/admin/organization/usage_audio_transcriptions_params"
@@ -1162,11 +1177,14 @@ require_relative "openai/resources/admin/organization/projects/model_permissions
 require_relative "openai/resources/admin/organization/projects/rate_limits"
 require_relative "openai/resources/admin/organization/projects/roles"
 require_relative "openai/resources/admin/organization/projects/service_accounts"
+require_relative "openai/resources/admin/organization/projects/service_accounts/api_keys"
 require_relative "openai/resources/admin/organization/projects/spend_alerts"
+require_relative "openai/resources/admin/organization/projects/spend_limit"
 require_relative "openai/resources/admin/organization/projects/users"
 require_relative "openai/resources/admin/organization/projects/users/roles"
 require_relative "openai/resources/admin/organization/roles"
 require_relative "openai/resources/admin/organization/spend_alerts"
+require_relative "openai/resources/admin/organization/spend_limit"
 require_relative "openai/resources/admin/organization/usage"
 require_relative "openai/resources/admin/organization/users"
 require_relative "openai/resources/admin/organization/users/roles"

data/rbi/openai/client.rbi

@@ -132,14 +132,29 @@ module OpenAI
     private def admin_api_key_auth
     end
 
+    # @api private
+    sig do
+      override
+        .params(
+          request: OpenAI::Internal::Transport::BaseClient::RequestInput,
+          redirect_count: Integer,
+          retry_count: Integer
+        )
+        .returns(OpenAI::Internal::Transport::BaseClient::RequestInput)
+    end
+    private def prepare_request(request, redirect_count:, retry_count:)
+    end
+
     # Creates and returns a new client for interacting with the API.
     sig do
       params(
         api_key: T.nilable(String),
         admin_api_key: T.nilable(String),
+        workload_identity: T.nilable(OpenAI::Auth::WorkloadIdentity),
         organization: T.nilable(String),
         project: T.nilable(String),
         webhook_secret: T.nilable(String),
+        provider: T.nilable(OpenAI::Provider),
         base_url: T.nilable(String),
         max_retries: Integer,
         timeout: Float,
@@ -152,12 +167,14 @@ module OpenAI
       api_key: ENV["OPENAI_API_KEY"],
       # Defaults to `ENV["OPENAI_ADMIN_KEY"]`
       admin_api_key: ENV["OPENAI_ADMIN_KEY"],
+      workload_identity: nil,
       # Defaults to `ENV["OPENAI_ORG_ID"]`
       organization: ENV["OPENAI_ORG_ID"],
       # Defaults to `ENV["OPENAI_PROJECT_ID"]`
       project: ENV["OPENAI_PROJECT_ID"],
       # Defaults to `ENV["OPENAI_WEBHOOK_SECRET"]`
       webhook_secret: ENV["OPENAI_WEBHOOK_SECRET"],
+      provider: nil,
       # Override the default base URL for the API, e.g.,
       # `"https://api.example.com/v2/"`. Defaults to `ENV["OPENAI_BASE_URL"]`
       base_url: ENV["OPENAI_BASE_URL"],

data/rbi/openai/internal/provider.rbi

@@ -0,0 +1,51 @@
+# typed: strong
+
+module OpenAI
+  module Internal
+    module Provider
+      class Runtime
+        sig { returns(String) }
+        attr_accessor :name
+
+        sig { returns(String) }
+        attr_accessor :base_url
+
+        sig do
+          returns(
+            T.nilable(
+              T
+                .proc
+                .params(
+                  request: OpenAI::Internal::Transport::BaseClient::RequestInput
+                )
+                .returns(OpenAI::Internal::Transport::BaseClient::RequestInput)
+            )
+          )
+        end
+        attr_accessor :prepare_request
+      end
+
+      class << self
+        sig do
+          params(definition: T.untyped).returns(OpenAI::Provider)
+        end
+        def create(definition)
+        end
+
+        sig do
+          params(provider: OpenAI::Provider).returns(String)
+        end
+        def name(provider)
+        end
+
+        sig do
+          params(provider: OpenAI::Provider).returns(
+            OpenAI::Internal::Provider::Runtime
+          )
+        end
+        def configure(provider)
+        end
+      end
+    end
+  end
+end

data/rbi/openai/internal/transport/base_client.rbi

@@ -188,6 +188,19 @@ module OpenAI
         private def auth_headers
         end
 
+        # @api private
+        sig do
+          overridable
+            .params(
+              request: OpenAI::Internal::Transport::BaseClient::RequestInput,
+              redirect_count: Integer,
+              retry_count: Integer
+            )
+            .returns(OpenAI::Internal::Transport::BaseClient::RequestInput)
+        end
+        private def prepare_request(request, redirect_count:, retry_count:)
+        end
+
         # @api private
         sig { returns(String) }
         private def user_agent
@@ -220,6 +233,25 @@ module OpenAI
         private def retry_delay(headers, retry_count:)
         end
 
+        # @api private
+        sig do
+          params(
+            url: URI::Generic,
+            status: Integer,
+            headers: T::Hash[String, String],
+            response: Net::HTTPResponse,
+            stream: T::Enumerable[String]
+          ).returns(T.noreturn)
+        end
+        private def raise_status_error!(
+          url:,
+          status:,
+          headers:,
+          response:,
+          stream:
+        )
+        end
+
         # @api private
         sig do
           params(