chore: ensure doc strings for rbi method arguments (#13)

Author: stainless-app[bot]

lib/openai/base_model.rb

@@ -876,8 +876,6 @@ def initialize(type_info, spec = {})
     end
   end
 
-  # @api private
-  #
   # @abstract
   #
   # @example
@@ -903,6 +901,8 @@ def known_fields
         @known_fields ||= (self < OpenAI::BaseModel ? superclass.known_fields.dup : {})
       end
 
+      # @api private
+      #
       # @return [Hash{Symbol=>Hash{Symbol=>Object}}]
       def fields
         known_fields.transform_values do |field|

lib/openai/base_page.rb

@@ -1,8 +1,6 @@
 # frozen_string_literal: true
 
 module OpenAI
-  # @api private
-  #
   # @abstract
   #
   # @example

lib/openai/base_stream.rb

@@ -1,8 +1,6 @@
 # frozen_string_literal: true
 
 module OpenAI
-  # @api private
-  #
   # @example
   # ```ruby
   # stream.for_each do |message|

lib/openai/stream.rb

@@ -1,8 +1,6 @@
 # frozen_string_literal: true
 
 module OpenAI
-  # @api private
-  #
   # @example
   # ```ruby
   # stream.for_each do |message|

rbi/lib/openai/base_model.rbi

@@ -438,6 +438,7 @@ module OpenAI
       def known_fields
       end
 
+      # @api private
       sig do
         returns(T::Hash[Symbol, T.all(OpenAI::BaseModel::KnownFieldShape, {type: OpenAI::Converter::Input})])
       end

rbi/lib/openai/base_page.rbi

@@ -1,7 +1,6 @@
 # typed: strong
 
 module OpenAI
-  # @api private
   module BasePage
     abstract!
 

rbi/lib/openai/base_stream.rbi

@@ -1,7 +1,6 @@
 # typed: strong
 
 module OpenAI
-  # @api private
   module BaseStream
     Message = type_member(:in)
     Elem = type_member(:out)

rbi/lib/openai/client.rbi

@@ -98,10 +98,15 @@ module OpenAI
         .returns(T.attached_class)
     end
     def self.new(
+      # Override the default base URL for the API, e.g., `"https://api.example.com/v2/"`
       base_url: nil,
+      # Defaults to `ENV["OPENAI_API_KEY"]`
       api_key: ENV["OPENAI_API_KEY"],
+      # Defaults to `ENV["OPENAI_ORG_ID"]`
       organization: ENV["OPENAI_ORG_ID"],
+      # Defaults to `ENV["OPENAI_PROJECT_ID"]`
       project: ENV["OPENAI_PROJECT_ID"],
+      # Max number of retries to attempt after a failed retryable request.
       max_retries: DEFAULT_MAX_RETRIES,
       timeout: DEFAULT_TIMEOUT_IN_SECONDS,
       initial_retry_delay: DEFAULT_INITIAL_RETRY_DELAY,

rbi/lib/openai/resources/audio/speech.rbi

@@ -16,7 +16,25 @@ module OpenAI
           )
             .returns(T.anything)
         end
-        def create(input:, model:, voice:, response_format: nil, speed: nil, request_options: {})
+        def create(
+          # 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):
+          #   `tts-1` or `tts-1-hd`
+          model:,
+          # The voice to use when generating the audio. Supported voices are `alloy`, `ash`,
+          #   `coral`, `echo`, `fable`, `onyx`, `nova`, `sage` and `shimmer`. Previews of the
+          #   voices are available in the
+          #   [Text to speech guide](https://platform.openai.com/docs/guides/text-to-speech#voice-options).
+          voice:,
+          # The format to audio in. Supported formats are `mp3`, `opus`, `aac`, `flac`,
+          #   `wav`, and `pcm`.
+          response_format: nil,
+          # The speed of the generated audio. Select a value from `0.25` to `4.0`. `1.0` is
+          #   the default.
+          speed: nil,
+          request_options: {}
+        )
         end
 
         sig { params(client: OpenAI::Client).returns(T.attached_class) }

rbi/lib/openai/resources/audio/transcriptions.rbi

@@ -19,12 +19,35 @@ module OpenAI
             .returns(T.any(OpenAI::Models::Audio::Transcription, OpenAI::Models::Audio::TranscriptionVerbose))
         end
         def create(
+          # The audio file object (not file name) to transcribe, in one of these formats:
+          #   flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, or webm.
           file:,
+          # ID of the model to use. Only `whisper-1` (which is powered by our open source
+          #   Whisper V2 model) is currently available.
           model:,
+          # The language of the input audio. Supplying the input language in
+          #   [ISO-639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) (e.g. `en`)
+          #   format will improve accuracy and latency.
           language: nil,
+          # 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)
+          #   should match the audio language.
           prompt: nil,
+          # The format of the output, in one of these options: `json`, `text`, `srt`,
+          #   `verbose_json`, or `vtt`.
           response_format: nil,
+          # The sampling temperature, between 0 and 1. Higher values like 0.8 will make the
+          #   output more random, while lower values like 0.2 will make it more focused and
+          #   deterministic. If set to 0, the model will use
+          #   [log probability](https://en.wikipedia.org/wiki/Log_probability) to
+          #   automatically increase the temperature until certain thresholds are hit.
           temperature: nil,
+          # The timestamp granularities to populate for this transcription.
+          #   `response_format` must be set `verbose_json` to use timestamp granularities.
+          #   Either or both of these options are supported: `word`, or `segment`. Note: There
+          #   is no additional latency for segment timestamps, but generating word timestamps
+          #   incurs additional latency.
           timestamp_granularities: nil,
           request_options: {}
         )