[ added ] added docs and example for audio methods

Author: anasfik

lib/src/instance/audio/audio.dart

@@ -22,7 +22,30 @@ class OpenAIAudio implements OpenAIAudioBase {
     OpenAILogger.logEndpoint(endpoint);
   }
 
- 
+  /// Creates a transcription for a given audio file.
+  ///
+  /// [file] is the [File] audio which is the audio file to be transcribed.
+  ///
+  /// [model] is the model which to use for the transcription.
+  ///
+  /// [prompt] is an optional text to guide the model's style or continue a previous audio segment. The prompt should be in English.
+  ///
+  /// [responseFormat] is an optional format for the transcription. The default is [OpenAIAudioResponseFormat.json].
+  ///
+  /// [temperature] is the sampling temperature for the request.
+  ///
+  /// [language] is the language of the input audio. Supplying the input language in **ISO-639-1** format will improve accuracy and latency.
+  ///
+  /// Example:
+  /// ```dart
+  /// final transcription = await openai.audio.createTranscription(
+  ///  file: File("audio.mp3"),
+  /// model: "whisper-1",
+  /// prompt: "This is a prompt",
+  /// responseFormat: OpenAIAudioResponseFormat.srt,
+  /// temperature: 0.5,
+  /// );
+  /// ```
   @override
   Future<OpenAIAudioModel> createTranscription({
     required File file,
@@ -48,6 +71,27 @@ class OpenAIAudio implements OpenAIAudioBase {
     );
   }
 
+  /// Creates a translation for a given audio file.
+  ///
+  /// [file] is the [File] audio which is the audio file to be transcribed.
+  ///
+  /// [model] is the model which to use for the transcription.
+  ///
+  /// [prompt] is an optional text to guide the model's style or continue a previous audio segment. The prompt should be in English.
+  ///
+  /// [responseFormat] is an optional format for the transcription. The default is [OpenAIAudioResponseFormat.json].
+  ///
+  /// [temperature] is the sampling temperature for the request.
+  ///
+  /// Example:
+  /// ```dart
+  /// final translation = await openai.audio.createTranslation(
+  /// file: File("audio.mp3"),
+  /// model: "whisper-1",
+  /// prompt: "This is a prompt",
+  /// responseFormat: OpenAIAudioResponseFormat.text,
+  /// );
+  /// ```
   @override
   Future<OpenAIAudioModel> createTranslation({
     required File file,