fix: correct types for audio responses

Author: RobertCraigie

src/resources/audio/transcriptions.ts

@@ -9,10 +9,22 @@ export class Transcriptions extends APIResource {
   /**
    * Transcribes audio into the input language.
    */
+  create(
+    body: TranscriptionCreateParams<'json'>,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<Transcription>;
+  create(
+    body: TranscriptionCreateParams<'verbose_json'>,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<TranscriptionVerbose>;
+  create(
+    body: TranscriptionCreateParams<'srt' | 'vtt' | 'text'>,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<string>;
   create(
     body: TranscriptionCreateParams,
     options?: Core.RequestOptions,
-  ): Core.APIPromise<TranscriptionCreateResponse> {
+  ): Core.APIPromise<TranscriptionCreateResponse | string> {
     return this._client.post('/audio/transcriptions', Core.multipartFormRequestOptions({ body, ...options }));
   }
 }
@@ -137,7 +149,9 @@ export interface TranscriptionWord {
  */
 export type TranscriptionCreateResponse = Transcription | TranscriptionVerbose;
 
-export interface TranscriptionCreateParams {
+export interface TranscriptionCreateParams<
+  ResponseFormat extends AudioAPI.AudioResponseFormat = AudioAPI.AudioResponseFormat,
+> {
   /**
    * The audio file object (not file name) to transcribe, in one of these formats:
    * flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, or webm.
@@ -169,7 +183,7 @@ export interface TranscriptionCreateParams {
    * The format of the output, in one of these options: `json`, `text`, `srt`,
    * `verbose_json`, or `vtt`.
    */
-  response_format?: AudioAPI.AudioResponseFormat;
+  response_format?: ResponseFormat;
 
   /**
    * The sampling temperature, between 0 and 1. Higher values like 0.8 will make the

src/resources/audio/translations.ts

@@ -10,10 +10,19 @@ export class Translations extends APIResource {
   /**
    * Translates audio into English.
    */
+  create(body: TranslationCreateParams<'json'>, options?: Core.RequestOptions): Core.APIPromise<Translation>;
+  create(
+    body: TranslationCreateParams<'verbose_json'>,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<TranslationVerbose>;
+  create(
+    body: TranslationCreateParams<'text' | 'srt' | 'vtt'>,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<string>;
   create(
     body: TranslationCreateParams,
     options?: Core.RequestOptions,
-  ): Core.APIPromise<TranslationCreateResponse> {
+  ): Core.APIPromise<TranslationCreateResponse | string> {
     return this._client.post('/audio/translations', Core.multipartFormRequestOptions({ body, ...options }));
   }
 }
@@ -46,7 +55,9 @@ export interface TranslationVerbose {
 
 export type TranslationCreateResponse = Translation | TranslationVerbose;
 
-export interface TranslationCreateParams {
+export interface TranslationCreateParams<
+  ResponseFormat extends AudioAPI.AudioResponseFormat = AudioAPI.AudioResponseFormat,
+> {
   /**
    * The audio file object (not file name) translate, in one of these formats: flac,
    * mp3, mp4, mpeg, mpga, m4a, ogg, wav, or webm.
@@ -71,7 +82,7 @@ export interface TranslationCreateParams {
    * The format of the output, in one of these options: `json`, `text`, `srt`,
    * `verbose_json`, or `vtt`.
    */
-  response_format?: AudioAPI.AudioResponseFormat;
+  response_format?: ResponseFormat;
 
   /**
    * The sampling temperature, between 0 and 1. Higher values like 0.8 will make the