openai 0.87.0 → 0.88.0

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

@@ -5,33 +5,46 @@ module OpenAI
     class Admin
       class Organization
         class Usage
-          # Some parameter documentations has been truncated, see
-          # {OpenAI::Models::Admin::Organization::UsageAudioSpeechesParams} for more
-          # details.
-          #
           # Get audio speeches usage details for the organization.
           #
           # @overload audio_speeches(start_time:, api_key_ids: nil, bucket_width: nil, end_time: nil, group_by: nil, limit: nil, models: nil, page: nil, project_ids: nil, user_ids: nil, request_options: {})
           #
-          # @param start_time [Integer] Start time (Unix seconds) of the query time range, inclusive.
+          # @param start_time [Integer]
+          #   Start time (Unix seconds) of the query time range, inclusive.
+          #
+          # @param api_key_ids [Array<String>]
+          #   Return only usage for these API keys.
           #
-          # @param api_key_ids [Array<String>] Return only usage for these API keys.
+          # @param bucket_width [Symbol, OpenAI::Models::Admin::Organization::UsageAudioSpeechesParams::BucketWidth]
+          #   Width of each time bucket in response. Currently `1m`, `1h` and `1d` are
+          #   supported, default to `1d`.
           #
-          # @param bucket_width [Symbol, OpenAI::Models::Admin::Organization::UsageAudioSpeechesParams::BucketWidth] Width of each time bucket in response. Currently `1m`, `1h` and `1d` are support
+          # @param end_time [Integer]
+          #   End time (Unix seconds) of the query time range, exclusive.
           #
-          # @param end_time [Integer] End time (Unix seconds) of the query time range, exclusive.
+          # @param group_by [Array<Symbol, OpenAI::Models::Admin::Organization::UsageAudioSpeechesParams::GroupBy>]
+          #   Group the usage data by the specified fields. Support fields include
+          #   `project_id`, `user_id`, `api_key_id`, `model` or any combination of them.
           #
-          # @param group_by [Array<Symbol, OpenAI::Models::Admin::Organization::UsageAudioSpeechesParams::GroupBy>] Group the usage data by the specified fields. Support fields include `project_id
+          # @param limit [Integer]
+          #   Specifies the number of buckets to return.
           #
-          # @param limit [Integer] Specifies the number of buckets to return.
+          #   - `bucket_width=1d`: default: 7, max: 31
+          #   - `bucket_width=1h`: default: 24, max: 168
+          #   - `bucket_width=1m`: default: 60, max: 1440
           #
-          # @param models [Array<String>] Return only usage for these models.
+          # @param models [Array<String>]
+          #   Return only usage for these models.
           #
-          # @param page [String] A cursor for use in pagination. Corresponding to the `next_page` field from the
+          # @param page [String]
+          #   A cursor for use in pagination. Corresponding to the `next_page` field from the
+          #   previous response.
           #
-          # @param project_ids [Array<String>] Return only usage for these projects.
+          # @param project_ids [Array<String>]
+          #   Return only usage for these projects.
           #
-          # @param user_ids [Array<String>] Return only usage for these users.
+          # @param user_ids [Array<String>]
+          #   Return only usage for these users.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -51,33 +64,46 @@ module OpenAI
             )
           end
 
-          # Some parameter documentations has been truncated, see
-          # {OpenAI::Models::Admin::Organization::UsageAudioTranscriptionsParams} for more
-          # details.
-          #
           # Get audio transcriptions usage details for the organization.
           #
           # @overload audio_transcriptions(start_time:, api_key_ids: nil, bucket_width: nil, end_time: nil, group_by: nil, limit: nil, models: nil, page: nil, project_ids: nil, user_ids: nil, request_options: {})
           #
-          # @param start_time [Integer] Start time (Unix seconds) of the query time range, inclusive.
+          # @param start_time [Integer]
+          #   Start time (Unix seconds) of the query time range, inclusive.
           #
-          # @param api_key_ids [Array<String>] Return only usage for these API keys.
+          # @param api_key_ids [Array<String>]
+          #   Return only usage for these API keys.
           #
-          # @param bucket_width [Symbol, OpenAI::Models::Admin::Organization::UsageAudioTranscriptionsParams::BucketWidth] Width of each time bucket in response. Currently `1m`, `1h` and `1d` are support
+          # @param bucket_width [Symbol, OpenAI::Models::Admin::Organization::UsageAudioTranscriptionsParams::BucketWidth]
+          #   Width of each time bucket in response. Currently `1m`, `1h` and `1d` are
+          #   supported, default to `1d`.
           #
-          # @param end_time [Integer] End time (Unix seconds) of the query time range, exclusive.
+          # @param end_time [Integer]
+          #   End time (Unix seconds) of the query time range, exclusive.
           #
-          # @param group_by [Array<Symbol, OpenAI::Models::Admin::Organization::UsageAudioTranscriptionsParams::GroupBy>] Group the usage data by the specified fields. Support fields include `project_id
+          # @param group_by [Array<Symbol, OpenAI::Models::Admin::Organization::UsageAudioTranscriptionsParams::GroupBy>]
+          #   Group the usage data by the specified fields. Support fields include
+          #   `project_id`, `user_id`, `api_key_id`, `model` or any combination of them.
           #
-          # @param limit [Integer] Specifies the number of buckets to return.
+          # @param limit [Integer]
+          #   Specifies the number of buckets to return.
           #
-          # @param models [Array<String>] Return only usage for these models.
+          #   - `bucket_width=1d`: default: 7, max: 31
+          #   - `bucket_width=1h`: default: 24, max: 168
+          #   - `bucket_width=1m`: default: 60, max: 1440
           #
-          # @param page [String] A cursor for use in pagination. Corresponding to the `next_page` field from the
+          # @param models [Array<String>]
+          #   Return only usage for these models.
           #
-          # @param project_ids [Array<String>] Return only usage for these projects.
+          # @param page [String]
+          #   A cursor for use in pagination. Corresponding to the `next_page` field from the
+          #   previous response.
           #
-          # @param user_ids [Array<String>] Return only usage for these users.
+          # @param project_ids [Array<String>]
+          #   Return only usage for these projects.
+          #
+          # @param user_ids [Array<String>]
+          #   Return only usage for these users.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -97,27 +123,37 @@ module OpenAI
             )
           end
 
-          # Some parameter documentations has been truncated, see
-          # {OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsParams} for
-          # more details.
-          #
           # Get code interpreter sessions usage details for the organization.
           #
           # @overload code_interpreter_sessions(start_time:, bucket_width: nil, end_time: nil, group_by: nil, limit: nil, page: nil, project_ids: nil, request_options: {})
           #
-          # @param start_time [Integer] Start time (Unix seconds) of the query time range, inclusive.
+          # @param start_time [Integer]
+          #   Start time (Unix seconds) of the query time range, inclusive.
+          #
+          # @param bucket_width [Symbol, OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsParams::BucketWidth]
+          #   Width of each time bucket in response. Currently `1m`, `1h` and `1d` are
+          #   supported, default to `1d`.
           #
-          # @param bucket_width [Symbol, OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsParams::BucketWidth] Width of each time bucket in response. Currently `1m`, `1h` and `1d` are support
+          # @param end_time [Integer]
+          #   End time (Unix seconds) of the query time range, exclusive.
           #
-          # @param end_time [Integer] End time (Unix seconds) of the query time range, exclusive.
+          # @param group_by [Array<Symbol, OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsParams::GroupBy>]
+          #   Group the usage data by the specified fields. Support fields include
+          #   `project_id`.
           #
-          # @param group_by [Array<Symbol, OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsParams::GroupBy>] Group the usage data by the specified fields. Support fields include `project_id
+          # @param limit [Integer]
+          #   Specifies the number of buckets to return.
           #
-          # @param limit [Integer] Specifies the number of buckets to return.
+          #   - `bucket_width=1d`: default: 7, max: 31
+          #   - `bucket_width=1h`: default: 24, max: 168
+          #   - `bucket_width=1m`: default: 60, max: 1440
           #
-          # @param page [String] A cursor for use in pagination. Corresponding to the `next_page` field from the
+          # @param page [String]
+          #   A cursor for use in pagination. Corresponding to the `next_page` field from the
+          #   previous response.
           #
-          # @param project_ids [Array<String>] Return only usage for these projects.
+          # @param project_ids [Array<String>]
+          #   Return only usage for these projects.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -137,34 +173,51 @@ module OpenAI
             )
           end
 
-          # Some parameter documentations has been truncated, see
-          # {OpenAI::Models::Admin::Organization::UsageCompletionsParams} for more details.
-          #
           # Get completions usage details for the organization.
           #
           # @overload completions(start_time:, api_key_ids: nil, batch: nil, bucket_width: nil, end_time: nil, group_by: nil, limit: nil, models: nil, page: nil, project_ids: nil, user_ids: nil, request_options: {})
           #
-          # @param start_time [Integer] Start time (Unix seconds) of the query time range, inclusive.
+          # @param start_time [Integer]
+          #   Start time (Unix seconds) of the query time range, inclusive.
+          #
+          # @param api_key_ids [Array<String>]
+          #   Return only usage for these API keys.
           #
-          # @param api_key_ids [Array<String>] Return only usage for these API keys.
+          # @param batch [Boolean]
+          #   If `true`, return batch jobs only. If `false`, return non-batch jobs only. By
+          #   default, return both.
           #
-          # @param batch [Boolean] If `true`, return batch jobs only. If `false`, return non-batch jobs only. By de
+          # @param bucket_width [Symbol, OpenAI::Models::Admin::Organization::UsageCompletionsParams::BucketWidth]
+          #   Width of each time bucket in response. Currently `1m`, `1h` and `1d` are
+          #   supported, default to `1d`.
           #
-          # @param bucket_width [Symbol, OpenAI::Models::Admin::Organization::UsageCompletionsParams::BucketWidth] Width of each time bucket in response. Currently `1m`, `1h` and `1d` are support
+          # @param end_time [Integer]
+          #   End time (Unix seconds) of the query time range, exclusive.
           #
-          # @param end_time [Integer] End time (Unix seconds) of the query time range, exclusive.
+          # @param group_by [Array<Symbol, OpenAI::Models::Admin::Organization::UsageCompletionsParams::GroupBy>]
+          #   Group the usage data by the specified fields. Support fields include
+          #   `project_id`, `user_id`, `api_key_id`, `model`, `batch`, `service_tier` or any
+          #   combination of them.
           #
-          # @param group_by [Array<Symbol, OpenAI::Models::Admin::Organization::UsageCompletionsParams::GroupBy>] Group the usage data by the specified fields. Support fields include `project_id
+          # @param limit [Integer]
+          #   Specifies the number of buckets to return.
           #
-          # @param limit [Integer] Specifies the number of buckets to return.
+          #   - `bucket_width=1d`: default: 7, max: 31
+          #   - `bucket_width=1h`: default: 24, max: 168
+          #   - `bucket_width=1m`: default: 60, max: 1440
           #
-          # @param models [Array<String>] Return only usage for these models.
+          # @param models [Array<String>]
+          #   Return only usage for these models.
           #
-          # @param page [String] A cursor for use in pagination. Corresponding to the `next_page` field from the
+          # @param page [String]
+          #   A cursor for use in pagination. Corresponding to the `next_page` field from the
+          #   previous response.
           #
-          # @param project_ids [Array<String>] Return only usage for these projects.
+          # @param project_ids [Array<String>]
+          #   Return only usage for these projects.
           #
-          # @param user_ids [Array<String>] Return only usage for these users.
+          # @param user_ids [Array<String>]
+          #   Return only usage for these users.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -184,30 +237,41 @@ module OpenAI
             )
           end
 
-          # Some parameter documentations has been truncated, see
-          # {OpenAI::Models::Admin::Organization::UsageCostsParams} for more details.
-          #
           # Get costs details for the organization.
           #
           # @overload costs(start_time:, api_key_ids: nil, bucket_width: nil, end_time: nil, group_by: nil, limit: nil, line_items: nil, page: nil, project_ids: nil, request_options: {})
           #
-          # @param start_time [Integer] Start time (Unix seconds) of the query time range, inclusive.
+          # @param start_time [Integer]
+          #   Start time (Unix seconds) of the query time range, inclusive.
           #
-          # @param api_key_ids [Array<String>] Return only costs for these API keys.
+          # @param api_key_ids [Array<String>]
+          #   Return only costs for these API keys.
           #
-          # @param bucket_width [Symbol, OpenAI::Models::Admin::Organization::UsageCostsParams::BucketWidth] Width of each time bucket in response. Currently only `1d` is supported, default
+          # @param bucket_width [Symbol, OpenAI::Models::Admin::Organization::UsageCostsParams::BucketWidth]
+          #   Width of each time bucket in response. Currently only `1d` is supported, default
+          #   to `1d`.
           #
-          # @param end_time [Integer] End time (Unix seconds) of the query time range, exclusive.
+          # @param end_time [Integer]
+          #   End time (Unix seconds) of the query time range, exclusive.
           #
-          # @param group_by [Array<Symbol, OpenAI::Models::Admin::Organization::UsageCostsParams::GroupBy>] Group the costs by the specified fields. Support fields include `project_id`, `l
+          # @param group_by [Array<Symbol, OpenAI::Models::Admin::Organization::UsageCostsParams::GroupBy>]
+          #   Group the costs by the specified fields. Support fields include `project_id`,
+          #   `line_item`, `api_key_id` and any combination of them.
           #
-          # @param limit [Integer] A limit on the number of buckets to be returned. Limit can range between 1 and 1
+          # @param limit [Integer]
+          #   A limit on the number of buckets to be returned. Limit can range between 1 and
+          #   180, and the default is 7.
           #
-          # @param line_items [Array<String>] Return only costs for these exact line item names. Each value must match the com
+          # @param line_items [Array<String>]
+          #   Return only costs for these exact line item names. Each value must match the
+          #   complete `line_item` value, for example `gpt-6-astra, input_tokens`.
           #
-          # @param page [String] A cursor for use in pagination. Corresponding to the `next_page` field from the
+          # @param page [String]
+          #   A cursor for use in pagination. Corresponding to the `next_page` field from the
+          #   previous response.
           #
-          # @param project_ids [Array<String>] Return only costs for these projects.
+          # @param project_ids [Array<String>]
+          #   Return only costs for these projects.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -227,32 +291,46 @@ module OpenAI
             )
           end
 
-          # Some parameter documentations has been truncated, see
-          # {OpenAI::Models::Admin::Organization::UsageEmbeddingsParams} for more details.
-          #
           # Get embeddings usage details for the organization.
           #
           # @overload embeddings(start_time:, api_key_ids: nil, bucket_width: nil, end_time: nil, group_by: nil, limit: nil, models: nil, page: nil, project_ids: nil, user_ids: nil, request_options: {})
           #
-          # @param start_time [Integer] Start time (Unix seconds) of the query time range, inclusive.
+          # @param start_time [Integer]
+          #   Start time (Unix seconds) of the query time range, inclusive.
+          #
+          # @param api_key_ids [Array<String>]
+          #   Return only usage for these API keys.
           #
-          # @param api_key_ids [Array<String>] Return only usage for these API keys.
+          # @param bucket_width [Symbol, OpenAI::Models::Admin::Organization::UsageEmbeddingsParams::BucketWidth]
+          #   Width of each time bucket in response. Currently `1m`, `1h` and `1d` are
+          #   supported, default to `1d`.
           #
-          # @param bucket_width [Symbol, OpenAI::Models::Admin::Organization::UsageEmbeddingsParams::BucketWidth] Width of each time bucket in response. Currently `1m`, `1h` and `1d` are support
+          # @param end_time [Integer]
+          #   End time (Unix seconds) of the query time range, exclusive.
           #
-          # @param end_time [Integer] End time (Unix seconds) of the query time range, exclusive.
+          # @param group_by [Array<Symbol, OpenAI::Models::Admin::Organization::UsageEmbeddingsParams::GroupBy>]
+          #   Group the usage data by the specified fields. Support fields include
+          #   `project_id`, `user_id`, `api_key_id`, `model` or any combination of them.
           #
-          # @param group_by [Array<Symbol, OpenAI::Models::Admin::Organization::UsageEmbeddingsParams::GroupBy>] Group the usage data by the specified fields. Support fields include `project_id
+          # @param limit [Integer]
+          #   Specifies the number of buckets to return.
           #
-          # @param limit [Integer] Specifies the number of buckets to return.
+          #   - `bucket_width=1d`: default: 7, max: 31
+          #   - `bucket_width=1h`: default: 24, max: 168
+          #   - `bucket_width=1m`: default: 60, max: 1440
           #
-          # @param models [Array<String>] Return only usage for these models.
+          # @param models [Array<String>]
+          #   Return only usage for these models.
           #
-          # @param page [String] A cursor for use in pagination. Corresponding to the `next_page` field from the
+          # @param page [String]
+          #   A cursor for use in pagination. Corresponding to the `next_page` field from the
+          #   previous response.
           #
-          # @param project_ids [Array<String>] Return only usage for these projects.
+          # @param project_ids [Array<String>]
+          #   Return only usage for these projects.
           #
-          # @param user_ids [Array<String>] Return only usage for these users.
+          # @param user_ids [Array<String>]
+          #   Return only usage for these users.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -272,33 +350,47 @@ module OpenAI
             )
           end
 
-          # Some parameter documentations has been truncated, see
-          # {OpenAI::Models::Admin::Organization::UsageFileSearchCallsParams} for more
-          # details.
-          #
           # Get file search calls usage details for the organization.
           #
           # @overload file_search_calls(start_time:, api_key_ids: nil, bucket_width: nil, end_time: nil, group_by: nil, limit: nil, page: nil, project_ids: nil, user_ids: nil, vector_store_ids: nil, request_options: {})
           #
-          # @param start_time [Integer] Start time (Unix seconds) of the query time range, inclusive.
+          # @param start_time [Integer]
+          #   Start time (Unix seconds) of the query time range, inclusive.
+          #
+          # @param api_key_ids [Array<String>]
+          #   Return only usage for these API keys.
           #
-          # @param api_key_ids [Array<String>] Return only usage for these API keys.
+          # @param bucket_width [Symbol, OpenAI::Models::Admin::Organization::UsageFileSearchCallsParams::BucketWidth]
+          #   Width of each time bucket in response. Currently `1m`, `1h` and `1d` are
+          #   supported, default to `1d`.
           #
-          # @param bucket_width [Symbol, OpenAI::Models::Admin::Organization::UsageFileSearchCallsParams::BucketWidth] Width of each time bucket in response. Currently `1m`, `1h` and `1d` are support
+          # @param end_time [Integer]
+          #   End time (Unix seconds) of the query time range, exclusive.
           #
-          # @param end_time [Integer] End time (Unix seconds) of the query time range, exclusive.
+          # @param group_by [Array<Symbol, OpenAI::Models::Admin::Organization::UsageFileSearchCallsParams::GroupBy>]
+          #   Group the usage data by the specified fields. Support fields include
+          #   `project_id`, `user_id`, `api_key_id`, `vector_store_id` or any combination of
+          #   them.
           #
-          # @param group_by [Array<Symbol, OpenAI::Models::Admin::Organization::UsageFileSearchCallsParams::GroupBy>] Group the usage data by the specified fields. Support fields include `project_id
+          # @param limit [Integer]
+          #   Specifies the number of buckets to return.
           #
-          # @param limit [Integer] Specifies the number of buckets to return.
+          #   - `bucket_width=1d`: default: 7, max: 31
+          #   - `bucket_width=1h`: default: 24, max: 168
+          #   - `bucket_width=1m`: default: 60, max: 1440
           #
-          # @param page [String] A cursor for use in pagination. Corresponding to the `next_page` field from the
+          # @param page [String]
+          #   A cursor for use in pagination. Corresponding to the `next_page` field from the
+          #   previous response.
           #
-          # @param project_ids [Array<String>] Return only usage for these projects.
+          # @param project_ids [Array<String>]
+          #   Return only usage for these projects.
           #
-          # @param user_ids [Array<String>] Return only usage for these users.
+          # @param user_ids [Array<String>]
+          #   Return only usage for these users.
           #
-          # @param vector_store_ids [Array<String>] Return only usage for these vector stores.
+          # @param vector_store_ids [Array<String>]
+          #   Return only usage for these vector stores.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -318,36 +410,55 @@ module OpenAI
             )
           end
 
-          # Some parameter documentations has been truncated, see
-          # {OpenAI::Models::Admin::Organization::UsageImagesParams} for more details.
-          #
           # Get images usage details for the organization.
           #
           # @overload images(start_time:, api_key_ids: nil, bucket_width: nil, end_time: nil, group_by: nil, limit: nil, models: nil, page: nil, project_ids: nil, sizes: nil, sources: nil, user_ids: nil, request_options: {})
           #
-          # @param start_time [Integer] Start time (Unix seconds) of the query time range, inclusive.
+          # @param start_time [Integer]
+          #   Start time (Unix seconds) of the query time range, inclusive.
           #
-          # @param api_key_ids [Array<String>] Return only usage for these API keys.
+          # @param api_key_ids [Array<String>]
+          #   Return only usage for these API keys.
           #
-          # @param bucket_width [Symbol, OpenAI::Models::Admin::Organization::UsageImagesParams::BucketWidth] Width of each time bucket in response. Currently `1m`, `1h` and `1d` are support
+          # @param bucket_width [Symbol, OpenAI::Models::Admin::Organization::UsageImagesParams::BucketWidth]
+          #   Width of each time bucket in response. Currently `1m`, `1h` and `1d` are
+          #   supported, default to `1d`.
           #
-          # @param end_time [Integer] End time (Unix seconds) of the query time range, exclusive.
+          # @param end_time [Integer]
+          #   End time (Unix seconds) of the query time range, exclusive.
           #
-          # @param group_by [Array<Symbol, OpenAI::Models::Admin::Organization::UsageImagesParams::GroupBy>] Group the usage data by the specified fields. Support fields include `project_id
+          # @param group_by [Array<Symbol, OpenAI::Models::Admin::Organization::UsageImagesParams::GroupBy>]
+          #   Group the usage data by the specified fields. Support fields include
+          #   `project_id`, `user_id`, `api_key_id`, `model`, `size`, `source` or any
+          #   combination of them.
           #
-          # @param limit [Integer] Specifies the number of buckets to return.
+          # @param limit [Integer]
+          #   Specifies the number of buckets to return.
           #
-          # @param models [Array<String>] Return only usage for these models.
+          #   - `bucket_width=1d`: default: 7, max: 31
+          #   - `bucket_width=1h`: default: 24, max: 168
+          #   - `bucket_width=1m`: default: 60, max: 1440
           #
-          # @param page [String] A cursor for use in pagination. Corresponding to the `next_page` field from the
+          # @param models [Array<String>]
+          #   Return only usage for these models.
           #
-          # @param project_ids [Array<String>] Return only usage for these projects.
+          # @param page [String]
+          #   A cursor for use in pagination. Corresponding to the `next_page` field from the
+          #   previous response.
           #
-          # @param sizes [Array<Symbol, OpenAI::Models::Admin::Organization::UsageImagesParams::Size>] Return only usages for these image sizes. Possible values are `256x256`, `512x51
+          # @param project_ids [Array<String>]
+          #   Return only usage for these projects.
           #
-          # @param sources [Array<Symbol, OpenAI::Models::Admin::Organization::UsageImagesParams::Source>] Return only usages for these sources. Possible values are `image.generation`, `i
+          # @param sizes [Array<Symbol, OpenAI::Models::Admin::Organization::UsageImagesParams::Size>]
+          #   Return only usages for these image sizes. Possible values are `256x256`,
+          #   `512x512`, `1024x1024`, `1792x1792`, `1024x1792` or any combination of them.
           #
-          # @param user_ids [Array<String>] Return only usage for these users.
+          # @param sources [Array<Symbol, OpenAI::Models::Admin::Organization::UsageImagesParams::Source>]
+          #   Return only usages for these sources. Possible values are `image.generation`,
+          #   `image.edit`, `image.variation` or any combination of them.
+          #
+          # @param user_ids [Array<String>]
+          #   Return only usage for these users.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -367,32 +478,46 @@ module OpenAI
             )
           end
 
-          # Some parameter documentations has been truncated, see
-          # {OpenAI::Models::Admin::Organization::UsageModerationsParams} for more details.
-          #
           # Get moderations usage details for the organization.
           #
           # @overload moderations(start_time:, api_key_ids: nil, bucket_width: nil, end_time: nil, group_by: nil, limit: nil, models: nil, page: nil, project_ids: nil, user_ids: nil, request_options: {})
           #
-          # @param start_time [Integer] Start time (Unix seconds) of the query time range, inclusive.
+          # @param start_time [Integer]
+          #   Start time (Unix seconds) of the query time range, inclusive.
           #
-          # @param api_key_ids [Array<String>] Return only usage for these API keys.
+          # @param api_key_ids [Array<String>]
+          #   Return only usage for these API keys.
           #
-          # @param bucket_width [Symbol, OpenAI::Models::Admin::Organization::UsageModerationsParams::BucketWidth] Width of each time bucket in response. Currently `1m`, `1h` and `1d` are support
+          # @param bucket_width [Symbol, OpenAI::Models::Admin::Organization::UsageModerationsParams::BucketWidth]
+          #   Width of each time bucket in response. Currently `1m`, `1h` and `1d` are
+          #   supported, default to `1d`.
           #
-          # @param end_time [Integer] End time (Unix seconds) of the query time range, exclusive.
+          # @param end_time [Integer]
+          #   End time (Unix seconds) of the query time range, exclusive.
           #
-          # @param group_by [Array<Symbol, OpenAI::Models::Admin::Organization::UsageModerationsParams::GroupBy>] Group the usage data by the specified fields. Support fields include `project_id
+          # @param group_by [Array<Symbol, OpenAI::Models::Admin::Organization::UsageModerationsParams::GroupBy>]
+          #   Group the usage data by the specified fields. Support fields include
+          #   `project_id`, `user_id`, `api_key_id`, `model` or any combination of them.
           #
-          # @param limit [Integer] Specifies the number of buckets to return.
+          # @param limit [Integer]
+          #   Specifies the number of buckets to return.
           #
-          # @param models [Array<String>] Return only usage for these models.
+          #   - `bucket_width=1d`: default: 7, max: 31
+          #   - `bucket_width=1h`: default: 24, max: 168
+          #   - `bucket_width=1m`: default: 60, max: 1440
           #
-          # @param page [String] A cursor for use in pagination. Corresponding to the `next_page` field from the
+          # @param models [Array<String>]
+          #   Return only usage for these models.
           #
-          # @param project_ids [Array<String>] Return only usage for these projects.
+          # @param page [String]
+          #   A cursor for use in pagination. Corresponding to the `next_page` field from the
+          #   previous response.
           #
-          # @param user_ids [Array<String>] Return only usage for these users.
+          # @param project_ids [Array<String>]
+          #   Return only usage for these projects.
+          #
+          # @param user_ids [Array<String>]
+          #   Return only usage for these users.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -412,26 +537,37 @@ module OpenAI
             )
           end
 
-          # Some parameter documentations has been truncated, see
-          # {OpenAI::Models::Admin::Organization::UsageVectorStoresParams} for more details.
-          #
           # Get vector stores usage details for the organization.
           #
           # @overload vector_stores(start_time:, bucket_width: nil, end_time: nil, group_by: nil, limit: nil, page: nil, project_ids: nil, request_options: {})
           #
-          # @param start_time [Integer] Start time (Unix seconds) of the query time range, inclusive.
+          # @param start_time [Integer]
+          #   Start time (Unix seconds) of the query time range, inclusive.
+          #
+          # @param bucket_width [Symbol, OpenAI::Models::Admin::Organization::UsageVectorStoresParams::BucketWidth]
+          #   Width of each time bucket in response. Currently `1m`, `1h` and `1d` are
+          #   supported, default to `1d`.
           #
-          # @param bucket_width [Symbol, OpenAI::Models::Admin::Organization::UsageVectorStoresParams::BucketWidth] Width of each time bucket in response. Currently `1m`, `1h` and `1d` are support
+          # @param end_time [Integer]
+          #   End time (Unix seconds) of the query time range, exclusive.
           #
-          # @param end_time [Integer] End time (Unix seconds) of the query time range, exclusive.
+          # @param group_by [Array<Symbol, OpenAI::Models::Admin::Organization::UsageVectorStoresParams::GroupBy>]
+          #   Group the usage data by the specified fields. Support fields include
+          #   `project_id`.
           #
-          # @param group_by [Array<Symbol, OpenAI::Models::Admin::Organization::UsageVectorStoresParams::GroupBy>] Group the usage data by the specified fields. Support fields include `project_id
+          # @param limit [Integer]
+          #   Specifies the number of buckets to return.
           #
-          # @param limit [Integer] Specifies the number of buckets to return.
+          #   - `bucket_width=1d`: default: 7, max: 31
+          #   - `bucket_width=1h`: default: 24, max: 168
+          #   - `bucket_width=1m`: default: 60, max: 1440
           #
-          # @param page [String] A cursor for use in pagination. Corresponding to the `next_page` field from the
+          # @param page [String]
+          #   A cursor for use in pagination. Corresponding to the `next_page` field from the
+          #   previous response.
           #
-          # @param project_ids [Array<String>] Return only usage for these projects.
+          # @param project_ids [Array<String>]
+          #   Return only usage for these projects.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -451,35 +587,50 @@ module OpenAI
             )
           end
 
-          # Some parameter documentations has been truncated, see
-          # {OpenAI::Models::Admin::Organization::UsageWebSearchCallsParams} for more
-          # details.
-          #
           # Get web search calls usage details for the organization.
           #
           # @overload web_search_calls(start_time:, api_key_ids: nil, bucket_width: nil, context_levels: nil, end_time: nil, group_by: nil, limit: nil, models: nil, page: nil, project_ids: nil, user_ids: nil, request_options: {})
           #
-          # @param start_time [Integer] Start time (Unix seconds) of the query time range, inclusive.
+          # @param start_time [Integer]
+          #   Start time (Unix seconds) of the query time range, inclusive.
+          #
+          # @param api_key_ids [Array<String>]
+          #   Return only usage for these API keys.
           #
-          # @param api_key_ids [Array<String>] Return only usage for these API keys.
+          # @param bucket_width [Symbol, OpenAI::Models::Admin::Organization::UsageWebSearchCallsParams::BucketWidth]
+          #   Width of each time bucket in response. Currently `1m`, `1h` and `1d` are
+          #   supported, default to `1d`.
           #
-          # @param bucket_width [Symbol, OpenAI::Models::Admin::Organization::UsageWebSearchCallsParams::BucketWidth] Width of each time bucket in response. Currently `1m`, `1h` and `1d` are support
+          # @param context_levels [Array<Symbol, OpenAI::Models::Admin::Organization::UsageWebSearchCallsParams::ContextLevel>]
+          #   Return only web search usage for these context levels.
           #
-          # @param context_levels [Array<Symbol, OpenAI::Models::Admin::Organization::UsageWebSearchCallsParams::ContextLevel>] Return only web search usage for these context levels.
+          # @param end_time [Integer]
+          #   End time (Unix seconds) of the query time range, exclusive.
           #
-          # @param end_time [Integer] End time (Unix seconds) of the query time range, exclusive.
+          # @param group_by [Array<Symbol, OpenAI::Models::Admin::Organization::UsageWebSearchCallsParams::GroupBy>]
+          #   Group the usage data by the specified fields. Support fields include
+          #   `project_id`, `user_id`, `api_key_id`, `model`, `context_level` or any
+          #   combination of them.
           #
-          # @param group_by [Array<Symbol, OpenAI::Models::Admin::Organization::UsageWebSearchCallsParams::GroupBy>] Group the usage data by the specified fields. Support fields include `project_id
+          # @param limit [Integer]
+          #   Specifies the number of buckets to return.
           #
-          # @param limit [Integer] Specifies the number of buckets to return.
+          #   - `bucket_width=1d`: default: 7, max: 31
+          #   - `bucket_width=1h`: default: 24, max: 168
+          #   - `bucket_width=1m`: default: 60, max: 1440
           #
-          # @param models [Array<String>] Return only usage for these models.
+          # @param models [Array<String>]
+          #   Return only usage for these models.
           #
-          # @param page [String] A cursor for use in pagination. Corresponding to the `next_page` field from the
+          # @param page [String]
+          #   A cursor for use in pagination. Corresponding to the `next_page` field from the
+          #   previous response.
           #
-          # @param project_ids [Array<String>] Return only usage for these projects.
+          # @param project_ids [Array<String>]
+          #   Return only usage for these projects.
           #
-          # @param user_ids [Array<String>] Return only usage for these users.
+          # @param user_ids [Array<String>]
+          #   Return only usage for these users.
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #