openai 0.87.0 → 0.88.0

data/lib/openai/resources/vector_stores.rb

@@ -9,24 +9,36 @@ module OpenAI
       # @return [OpenAI::Resources::VectorStores::FileBatches]
       attr_reader :file_batches
 
-      # Some parameter documentations has been truncated, see
-      # {OpenAI::Models::VectorStoreCreateParams} for more details.
-      #
       # Create a vector store.
       #
       # @overload create(chunking_strategy: nil, description: nil, expires_after: nil, file_ids: nil, metadata: nil, name: nil, request_options: {})
       #
-      # @param chunking_strategy [OpenAI::Models::AutoFileChunkingStrategyParam, OpenAI::Models::StaticFileChunkingStrategyObjectParam] The chunking strategy used to chunk the file(s). If not set, will use the `auto`
+      # @param chunking_strategy [OpenAI::Models::AutoFileChunkingStrategyParam, OpenAI::Models::StaticFileChunkingStrategyObjectParam]
+      #   The chunking strategy used to chunk the file(s). If not set, will use the `auto`
+      #   strategy. Only applicable if `file_ids` is non-empty.
+      #
+      # @param description [String]
+      #   A description for the vector store. Can be used to describe the vector store's
+      #   purpose.
       #
-      # @param description [String] A description for the vector store. Can be used to describe the vector store's p
+      # @param expires_after [OpenAI::Models::VectorStoreCreateParams::ExpiresAfter]
+      #   The expiration policy for a vector store.
       #
-      # @param expires_after [OpenAI::Models::VectorStoreCreateParams::ExpiresAfter] The expiration policy for a vector store.
+      # @param file_ids [Array<String>]
+      #   A list of [File](https://developers.openai.com/api/reference/resources/files)
+      #   IDs that the vector store should use. Useful for tools like `file_search` that
+      #   can access files.
       #
-      # @param file_ids [Array<String>] A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that
+      # @param metadata [Hash{Symbol=>String}, nil]
+      #   Set of 16 key-value pairs that can be attached to an object. This can be useful
+      #   for storing additional information about the object in a structured format, and
+      #   querying for objects via API or the dashboard.
       #
-      # @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
+      #   Keys are strings with a maximum length of 64 characters. Values are strings with
+      #   a maximum length of 512 characters.
       #
-      # @param name [String] The name of the vector store.
+      # @param name [String]
+      #   The name of the vector store.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -49,7 +61,8 @@ module OpenAI
       #
       # @overload retrieve(vector_store_id, request_options: {})
       #
-      # @param vector_store_id [String] The ID of the vector store to retrieve.
+      # @param vector_store_id [String]
+      #   The ID of the vector store to retrieve.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -66,20 +79,26 @@ module OpenAI
         )
       end
 
-      # Some parameter documentations has been truncated, see
-      # {OpenAI::Models::VectorStoreUpdateParams} for more details.
-      #
       # Modifies a vector store.
       #
       # @overload update(vector_store_id, expires_after: nil, metadata: nil, name: nil, request_options: {})
       #
-      # @param vector_store_id [String] The ID of the vector store to modify.
+      # @param vector_store_id [String]
+      #   The ID of the vector store to modify.
       #
-      # @param expires_after [OpenAI::Models::VectorStoreUpdateParams::ExpiresAfter, nil] The expiration policy for a vector store.
+      # @param expires_after [OpenAI::Models::VectorStoreUpdateParams::ExpiresAfter, nil]
+      #   The expiration policy for a vector store.
       #
-      # @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
+      # @param metadata [Hash{Symbol=>String}, nil]
+      #   Set of 16 key-value pairs that can be attached to an object. This can be useful
+      #   for storing additional information about the object in a structured format, and
+      #   querying for objects via API or the dashboard.
       #
-      # @param name [String, nil] The name of the vector store.
+      #   Keys are strings with a maximum length of 64 characters. Values are strings with
+      #   a maximum length of 512 characters.
+      #
+      # @param name [String, nil]
+      #   The name of the vector store.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -98,20 +117,29 @@ module OpenAI
         )
       end
 
-      # Some parameter documentations has been truncated, see
-      # {OpenAI::Models::VectorStoreListParams} for more details.
-      #
       # Returns a list of vector stores.
       #
       # @overload list(after: nil, before: nil, limit: nil, order: nil, request_options: {})
       #
-      # @param after [String] A cursor for use in pagination. `after` is an object ID that defines your place
+      # @param after [String]
+      #   A cursor for use in pagination. `after` is an object ID that defines your place
+      #   in the list. For instance, if you make a list request and receive 100 objects,
+      #   ending with obj_foo, your subsequent call can include after=obj_foo in order to
+      #   fetch the next page of the list.
       #
-      # @param before [String] A cursor for use in pagination. `before` is an object ID that defines your place
+      # @param before [String]
+      #   A cursor for use in pagination. `before` is an object ID that defines your place
+      #   in the list. For instance, if you make a list request and receive 100 objects,
+      #   starting with obj_foo, your subsequent call can include before=obj_foo in order
+      #   to fetch the previous page of the list.
       #
-      # @param limit [Integer] A limit on the number of objects to be returned. Limit can range between 1 and 1
+      # @param limit [Integer]
+      #   A limit on the number of objects to be returned. Limit can range between 1 and
+      #   100, and the default is 20.
       #
-      # @param order [Symbol, OpenAI::Models::VectorStoreListParams::Order] Sort order by the `created_at` timestamp of the objects. `asc` for ascending ord
+      # @param order [Symbol, OpenAI::Models::VectorStoreListParams::Order]
+      #   Sort order by the `created_at` timestamp of the objects. `asc` for ascending
+      #   order and `desc` for descending order.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -136,7 +164,8 @@ module OpenAI
       #
       # @overload delete(vector_store_id, request_options: {})
       #
-      # @param vector_store_id [String] The ID of the vector store to delete.
+      # @param vector_store_id [String]
+      #   The ID of the vector store to delete.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -153,25 +182,29 @@ module OpenAI
         )
       end
 
-      # Some parameter documentations has been truncated, see
-      # {OpenAI::Models::VectorStoreSearchParams} for more details.
-      #
       # Search a vector store for relevant chunks based on a query and file attributes
       # filter.
       #
       # @overload search(vector_store_id, query:, filters: nil, max_num_results: nil, ranking_options: nil, rewrite_query: nil, request_options: {})
       #
-      # @param vector_store_id [String] The ID of the vector store to search.
+      # @param vector_store_id [String]
+      #   The ID of the vector store to search.
       #
-      # @param query [String, Array<String>] A query string for a search
+      # @param query [String, Array<String>]
+      #   A query string for a search
       #
-      # @param filters [OpenAI::Models::ComparisonFilter, OpenAI::Models::CompoundFilter] A filter to apply based on file attributes.
+      # @param filters [OpenAI::Models::ComparisonFilter, OpenAI::Models::CompoundFilter]
+      #   A filter to apply based on file attributes.
       #
-      # @param max_num_results [Integer] The maximum number of results to return. This number should be between 1 and 50
+      # @param max_num_results [Integer]
+      #   The maximum number of results to return. This number should be between 1 and 50
+      #   inclusive.
       #
-      # @param ranking_options [OpenAI::Models::VectorStoreSearchParams::RankingOptions] Ranking options for search.
+      # @param ranking_options [OpenAI::Models::VectorStoreSearchParams::RankingOptions]
+      #   Ranking options for search.
       #
-      # @param rewrite_query [Boolean] Whether to rewrite the natural language query for vector search.
+      # @param rewrite_query [Boolean]
+      #   Whether to rewrite the natural language query for vector search.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/openai/resources/videos.rb

@@ -7,9 +7,6 @@ module OpenAI
     class Videos
       # @deprecated The Sora API is scheduled to permanently shut down on September 24, 2026.
       #
-      # Some parameter documentations has been truncated, see
-      # {OpenAI::Models::VideoCreateParams} for more details.
-      #
       # Create a new video generation job from a prompt and optional reference assets.
       #
       # `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
@@ -18,15 +15,26 @@ module OpenAI
       #
       # @overload create(prompt:, input_reference: nil, model: nil, seconds: nil, size: nil, request_options: {})
       #
-      # @param prompt [String] Text prompt that describes the video to generate.
+      # @param prompt [String]
+      #   Text prompt that describes the video to generate.
+      #
+      # @param input_reference [Pathname, StringIO, IO, String, OpenAI::FilePart, OpenAI::Models::ImageInputReferenceParam]
+      #   Optional reference asset upload or reference object that guides generation.
       #
-      # @param input_reference [Pathname, StringIO, IO, String, OpenAI::FilePart, OpenAI::Models::ImageInputReferenceParam] Optional reference asset upload or reference object that guides generation.
+      #   `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
+      #   metadata. Use `OpenAI::FilePart` when you need to override the filename or
+      #   content type.
       #
-      # @param model [String, Symbol, OpenAI::Models::VideoModel] The video generation model to use (allowed values: sora-2, sora-2-pro). Defaults
+      # @param model [String, Symbol, OpenAI::Models::VideoModel]
+      #   The video generation model to use (allowed values: sora-2, sora-2-pro). Defaults
+      #   to `sora-2`.
       #
-      # @param seconds [Symbol, OpenAI::Models::VideoSeconds] Clip duration in seconds (allowed values: 4, 8, 12). Defaults to 4 seconds.
+      # @param seconds [Symbol, OpenAI::Models::VideoSeconds]
+      #   Clip duration in seconds (allowed values: 4, 8, 12). Defaults to 4 seconds.
       #
-      # @param size [Symbol, OpenAI::Models::VideoSize] Output resolution formatted as width x height (allowed values: 720x1280, 1280x72
+      # @param size [Symbol, OpenAI::Models::VideoSize]
+      #   Output resolution formatted as width x height (allowed values: 720x1280,
+      #   1280x720, 1024x1792, 1792x1024). Defaults to 720x1280.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -52,7 +60,8 @@ module OpenAI
       #
       # @overload retrieve(video_id, request_options: {})
       #
-      # @param video_id [String] The identifier of the video to retrieve.
+      # @param video_id [String]
+      #   The identifier of the video to retrieve.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -71,18 +80,19 @@ module OpenAI
 
       # @deprecated The Sora API is scheduled to permanently shut down on September 24, 2026.
       #
-      # Some parameter documentations has been truncated, see
-      # {OpenAI::Models::VideoListParams} for more details.
-      #
       # List recently generated videos for the current project.
       #
       # @overload list(after: nil, limit: nil, order: nil, request_options: {})
       #
-      # @param after [String] Identifier for the last item from the previous pagination request
+      # @param after [String]
+      #   Identifier for the last item from the previous pagination request
       #
-      # @param limit [Integer] Number of items to retrieve
+      # @param limit [Integer]
+      #   Number of items to retrieve
       #
-      # @param order [Symbol, OpenAI::Models::VideoListParams::Order] Sort order of results by timestamp. Use `asc` for ascending order or `desc` for
+      # @param order [Symbol, OpenAI::Models::VideoListParams::Order]
+      #   Sort order of results by timestamp. Use `asc` for ascending order or `desc` for
+      #   descending order.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -109,7 +119,8 @@ module OpenAI
       #
       # @overload delete(video_id, request_options: {})
       #
-      # @param video_id [String] The identifier of the video to delete.
+      # @param video_id [String]
+      #   The identifier of the video to delete.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -136,9 +147,15 @@ module OpenAI
       #
       # @overload create_character(name:, video:, request_options: {})
       #
-      # @param name [String] Display name for this API character.
+      # @param name [String]
+      #   Display name for this API character.
+      #
+      # @param video [Pathname, StringIO, IO, String, OpenAI::FilePart]
+      #   Video file used to create a character.
       #
-      # @param video [Pathname, StringIO, IO, String, OpenAI::FilePart] Video file used to create a character.
+      #   `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
+      #   metadata. Use `OpenAI::FilePart` when you need to override the filename or
+      #   content type.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -166,9 +183,11 @@ module OpenAI
       #
       # @overload download_content(video_id, variant: nil, request_options: {})
       #
-      # @param video_id [String] The identifier of the video whose media to download.
+      # @param video_id [String]
+      #   The identifier of the video whose media to download.
       #
-      # @param variant [Symbol, OpenAI::Models::VideoDownloadContentParams::Variant] Which downloadable asset to return. Defaults to the MP4 video.
+      # @param variant [Symbol, OpenAI::Models::VideoDownloadContentParams::Variant]
+      #   Which downloadable asset to return. Defaults to the MP4 video.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -200,9 +219,15 @@ module OpenAI
       #
       # @overload edit(prompt:, video:, request_options: {})
       #
-      # @param prompt [String] Text prompt that describes how to edit the source video.
+      # @param prompt [String]
+      #   Text prompt that describes how to edit the source video.
       #
-      # @param video [Pathname, StringIO, IO, String, OpenAI::FilePart, OpenAI::Models::VideoEditParams::Video::VideoReferenceInputParam] Reference to the completed video to edit.
+      # @param video [Pathname, StringIO, IO, String, OpenAI::FilePart, OpenAI::Models::VideoEditParams::Video::VideoReferenceInputParam]
+      #   Reference to the completed video to edit.
+      #
+      #   `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
+      #   metadata. Use `OpenAI::FilePart` when you need to override the filename or
+      #   content type.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -224,9 +249,6 @@ module OpenAI
 
       # @deprecated The Sora API is scheduled to permanently shut down on September 24, 2026.
       #
-      # Some parameter documentations has been truncated, see
-      # {OpenAI::Models::VideoExtendParams} for more details.
-      #
       # Create an extension of a completed video.
       #
       # `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
@@ -235,11 +257,19 @@ module OpenAI
       #
       # @overload extend_(prompt:, seconds:, video:, request_options: {})
       #
-      # @param prompt [String] Updated text prompt that directs the extension generation.
+      # @param prompt [String]
+      #   Updated text prompt that directs the extension generation.
+      #
+      # @param seconds [Symbol, OpenAI::Models::VideoSeconds]
+      #   Length of the newly generated extension segment in seconds (allowed values: 4,
+      #   8, 12, 16, 20).
       #
-      # @param seconds [Symbol, OpenAI::Models::VideoSeconds] Length of the newly generated extension segment in seconds (allowed values: 4, 8
+      # @param video [Pathname, StringIO, IO, String, OpenAI::FilePart, OpenAI::Models::VideoExtendParams::Video::VideoReferenceInputParam]
+      #   Reference to the completed video to extend.
       #
-      # @param video [Pathname, StringIO, IO, String, OpenAI::FilePart, OpenAI::Models::VideoExtendParams::Video::VideoReferenceInputParam] Reference to the completed video to extend.
+      #   `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
+      #   metadata. Use `OpenAI::FilePart` when you need to override the filename or
+      #   content type.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -265,7 +295,8 @@ module OpenAI
       #
       # @overload get_character(character_id, request_options: {})
       #
-      # @param character_id [String] The identifier of the character to retrieve.
+      # @param character_id [String]
+      #   The identifier of the character to retrieve.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -288,9 +319,11 @@ module OpenAI
       #
       # @overload remix(video_id, prompt:, request_options: {})
       #
-      # @param video_id [String] The identifier of the completed video to remix.
+      # @param video_id [String]
+      #   The identifier of the completed video to remix.
       #
-      # @param prompt [String] Updated text prompt that directs the remix generation.
+      # @param prompt [String]
+      #   Updated text prompt that directs the remix generation.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/openai/version.rb

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

data/rbi/openai/models/admin/organization/audit_log_list_params.rbi

@@ -63,7 +63,7 @@ module OpenAI
 
           # Return only events with a `type` in one of these values. For example,
           # `project.created`. For all options, see the documentation for the
-          # [audit log object](https://platform.openai.com/docs/api-reference/audit-logs/object).
+          # [audit log object](https://developers.openai.com/api/reference/resources/admin/subresources/organization/subresources/audit_logs).
           sig { returns(T.nilable(T::Array[OpenAI::Admin::Organization::AuditLogListParams::EventType::OrSymbol])) }
           attr_reader :event_types
 
@@ -159,7 +159,7 @@ module OpenAI
 
             # Return only events with a `type` in one of these values. For example,
             # `project.created`. For all options, see the documentation for the
-            # [audit log object](https://platform.openai.com/docs/api-reference/audit-logs/object).
+            # [audit log object](https://developers.openai.com/api/reference/resources/admin/subresources/organization/subresources/audit_logs).
             event_types: nil,
 
             # A limit on the number of objects to be returned. Limit can range between 1 and

data/rbi/openai/models/admin/organization/project_create_params.rbi

@@ -29,7 +29,7 @@ module OpenAI
 
           # Create the project with the specified data residency region. Your organization
           # must have access to Data residency functionality in order to use. See
-          # [data residency controls](https://platform.openai.com/docs/guides/your-data#data-residency-controls)
+          # [data residency controls](https://developers.openai.com/api/docs/guides/your-data#data-residency-controls)
           # to review the functionality and limitations of setting this field. Deprecated:
           # use `residency` instead. Do not provide both `geography` and `residency`.
           sig { returns(T.nilable(String)) }
@@ -38,7 +38,7 @@ module OpenAI
           # Create the project with the specified residency configuration. Your organization
           # must have access to the requested residency configuration in order to use it.
           # See
-          # [data residency controls](https://platform.openai.com/docs/guides/your-data#data-residency-controls)
+          # [data residency controls](https://developers.openai.com/api/docs/guides/your-data#data-residency-controls)
           # to review the functionality and limitations of setting this field.
           sig { returns(T.nilable(OpenAI::Admin::Organization::ProjectResidency::OrSymbol)) }
           attr_accessor :residency
@@ -68,7 +68,7 @@ module OpenAI
 
             # Create the project with the specified data residency region. Your organization
             # must have access to Data residency functionality in order to use. See
-            # [data residency controls](https://platform.openai.com/docs/guides/your-data#data-residency-controls)
+            # [data residency controls](https://developers.openai.com/api/docs/guides/your-data#data-residency-controls)
             # to review the functionality and limitations of setting this field. Deprecated:
             # use `residency` instead. Do not provide both `geography` and `residency`.
             geography: nil,
@@ -76,7 +76,7 @@ module OpenAI
             # Create the project with the specified residency configuration. Your organization
             # must have access to the requested residency configuration in order to use it.
             # See
-            # [data residency controls](https://platform.openai.com/docs/guides/your-data#data-residency-controls)
+            # [data residency controls](https://developers.openai.com/api/docs/guides/your-data#data-residency-controls)
             # to review the functionality and limitations of setting this field.
             residency: nil,
 

data/rbi/openai/models/admin/organization/projects/project_api_key.rbi

@@ -54,6 +54,11 @@ module OpenAI
             sig { returns(String) }
             attr_accessor :redacted_value
 
+            # The Unix timestamp (in seconds) when the API key expires, or null if it does not
+            # expire.
+            sig { returns(T.nilable(Integer)) }
+            attr_accessor :expires_at
+
             # Represents an individual API key in a project.
             sig do
               params(
@@ -72,6 +77,8 @@ module OpenAI
 
                 redacted_value: String,
 
+                expires_at: T.nilable(Integer),
+
                 object: Symbol
               )
                 .returns(T.attached_class)
@@ -98,6 +105,10 @@ module OpenAI
               # The redacted value of the API key
               redacted_value:,
 
+              # The Unix timestamp (in seconds) when the API key expires, or null if it does not
+              # expire.
+              expires_at: nil,
+
               # The object type, which is always `organization.project.api_key`
 
               object: :"organization.project.api_key"
@@ -114,7 +125,8 @@ module OpenAI
                   object: Symbol,
                   owner: OpenAI::Admin::Organization::Projects::ProjectAPIKey::Owner,
                   owner_project_access: OpenAI::Admin::Organization::Projects::ProjectAPIKey::OwnerProjectAccess::TaggedSymbol,
-                  redacted_value: String
+                  redacted_value: String,
+                  expires_at: T.nilable(Integer)
                 }
               )
             end

data/rbi/openai/models/admin/organization/projects/service_account_create_params.rbi

@@ -32,6 +32,14 @@ module OpenAI
             sig { returns(T.nilable(T::Boolean)) }
             attr_accessor :create_service_account_only
 
+            # Number of seconds until the initial API key expires. If omitted or null, the key
+            # does not expire unless the effective organization or project policy requires an
+            # expiration. When a policy sets a maximum lifetime, this value must be provided
+            # and must not exceed that limit. A non-null value cannot be used when
+            # `create_service_account_only` is true.
+            sig { returns(T.nilable(Integer)) }
+            attr_accessor :expires_in_seconds
+
             sig do
               params(
 
@@ -41,6 +49,8 @@ module OpenAI
 
                 create_service_account_only: T.nilable(T::Boolean),
 
+                expires_in_seconds: T.nilable(Integer),
+
                 request_options: OpenAI::RequestOptions::OrHash
               )
                 .returns(T.attached_class)
@@ -55,6 +65,13 @@ module OpenAI
               # Create the service account without default roles or an API key.
               create_service_account_only: nil,
 
+              # Number of seconds until the initial API key expires. If omitted or null, the key
+              # does not expire unless the effective organization or project policy requires an
+              # expiration. When a policy sets a maximum lifetime, this value must be provided
+              # and must not exceed that limit. A non-null value cannot be used when
+              # `create_service_account_only` is true.
+              expires_in_seconds: nil,
+
               request_options: {}
             )
             end
@@ -65,6 +82,7 @@ module OpenAI
                   project_id: String,
                   name: String,
                   create_service_account_only: T.nilable(T::Boolean),
+                  expires_in_seconds: T.nilable(Integer),
                   request_options: OpenAI::RequestOptions
                 }
               )

data/rbi/openai/models/admin/organization/projects/service_account_create_response.rbi

@@ -130,6 +130,11 @@ module OpenAI
               sig { returns(String) }
               attr_accessor :value
 
+              # The Unix timestamp (in seconds) when the API key expires, or null if it does not
+              # expire.
+              sig { returns(T.nilable(Integer)) }
+              attr_accessor :expires_at
+
               sig do
                 params(
 
@@ -141,6 +146,8 @@ module OpenAI
 
                   value: String,
 
+                  expires_at: T.nilable(Integer),
+
                   object: Symbol
                 )
                   .returns(T.attached_class)
@@ -155,6 +162,10 @@ module OpenAI
 
                 value:,
 
+                # The Unix timestamp (in seconds) when the API key expires, or null if it does not
+                # expire.
+                expires_at: nil,
+
                 # The object type, which is always `organization.project.service_account.api_key`
 
                 object: :"organization.project.service_account.api_key"
@@ -163,7 +174,14 @@ module OpenAI
 
               sig do
                 override.returns(
-                  {id: String, created_at: Integer, name: String, object: Symbol, value: String}
+                  {
+                    id: String,
+                    created_at: Integer,
+                    name: String,
+                    object: Symbol,
+                    value: String,
+                    expires_at: T.nilable(Integer)
+                  }
                 )
               end
               def to_hash

data/rbi/openai/models/audio/speech_create_params.rbi

@@ -21,7 +21,8 @@ module OpenAI
         sig { returns(String) }
         attr_accessor :input
 
-        # One of the available [TTS models](https://platform.openai.com/docs/models#tts):
+        # One of the available
+        # [TTS models](https://developers.openai.com/api/docs/guides/text-to-speech):
         # `tts-1`, `tts-1-hd`, `gpt-4o-mini-tts`, or `gpt-4o-mini-tts-2025-12-15`.
         sig { returns(T.any(String, OpenAI::Audio::SpeechModel::OrSymbol)) }
         attr_accessor :model
@@ -31,7 +32,7 @@ module OpenAI
         # `shimmer`, `verse`, `marin`, and `cedar`. You may also provide a custom voice
         # object with an `id`, for example `{ "id": "voice_1234" }`. Previews of the
         # voices are available in the
-        # [Text to speech guide](https://platform.openai.com/docs/guides/text-to-speech#voice-options).
+        # [Text to speech guide](https://developers.openai.com/api/docs/guides/text-to-speech#voice-options).
         sig {
           returns(
             T.any(
@@ -105,7 +106,8 @@ module OpenAI
           # The text to generate audio for. The maximum length is 4096 characters.
           input:,
 
-          # One of the available [TTS models](https://platform.openai.com/docs/models#tts):
+          # One of the available
+          # [TTS models](https://developers.openai.com/api/docs/guides/text-to-speech):
           # `tts-1`, `tts-1-hd`, `gpt-4o-mini-tts`, or `gpt-4o-mini-tts-2025-12-15`.
           model:,
 
@@ -114,7 +116,7 @@ module OpenAI
           # `shimmer`, `verse`, `marin`, and `cedar`. You may also provide a custom voice
           # object with an `id`, for example `{ "id": "voice_1234" }`. Previews of the
           # voices are available in the
-          # [Text to speech guide](https://platform.openai.com/docs/guides/text-to-speech#voice-options).
+          # [Text to speech guide](https://developers.openai.com/api/docs/guides/text-to-speech#voice-options).
           voice:,
 
           # Control the voice of your generated audio with additional instructions. Does not
@@ -158,7 +160,8 @@ module OpenAI
         def to_hash
         end
 
-        # One of the available [TTS models](https://platform.openai.com/docs/models#tts):
+        # One of the available
+        # [TTS models](https://developers.openai.com/api/docs/guides/text-to-speech):
         # `tts-1`, `tts-1-hd`, `gpt-4o-mini-tts`, or `gpt-4o-mini-tts-2025-12-15`.
         module Model
           extend OpenAI::Internal::Type::Union
@@ -176,7 +179,7 @@ module OpenAI
         # `shimmer`, `verse`, `marin`, and `cedar`. You may also provide a custom voice
         # object with an `id`, for example `{ "id": "voice_1234" }`. Previews of the
         # voices are available in the
-        # [Text to speech guide](https://platform.openai.com/docs/guides/text-to-speech#voice-options).
+        # [Text to speech guide](https://developers.openai.com/api/docs/guides/text-to-speech#voice-options).
         module Voice
           extend OpenAI::Internal::Type::Union
 

data/rbi/openai/models/audio/transcription_create_params.rbi

@@ -106,7 +106,7 @@ module OpenAI
 
         # 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)
+        # [prompt](https://developers.openai.com/api/docs/guides/speech-to-text#prompting)
         # should match the audio language. This field is not supported when using
         # `gpt-4o-transcribe-diarize`.
         sig { returns(T.nilable(String)) }
@@ -251,7 +251,7 @@ module OpenAI
 
           # 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)
+          # [prompt](https://developers.openai.com/api/docs/guides/speech-to-text#prompting)
           # should match the audio language. This field is not supported when using
           # `gpt-4o-transcribe-diarize`.
           prompt: nil,

data/rbi/openai/models/audio/transcription_stream_event.rbi

@@ -7,7 +7,7 @@ module OpenAI
 
       # Emitted when a diarized transcription returns a completed segment with speaker
       # information. Only emitted when you
-      # [create a transcription](https://platform.openai.com/docs/api-reference/audio/create-transcription)
+      # [create a transcription](https://developers.openai.com/api/reference/resources/audio/subresources/transcriptions/methods/create)
       # with `stream` set to `true` and `response_format` set to `diarized_json`.
       module TranscriptionStreamEvent
         extend OpenAI::Internal::Type::Union