fix(client): correct types for transcriptions / translations (#1105)

Author: stainless-app[bot]

.stats.yml

@@ -1,2 +1,2 @@
 configured_endpoints: 68
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai-17ddd746c775ca4d4fbe64e5621ac30756ef09c061ff6313190b6ec162222d4c.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai-71e58a77027c67e003fdd1b1ac8ac11557d8bfabc7666d1a827c6b1ca8ab98b5.yml

api.md

@@ -114,20 +114,26 @@ Types:
 Types:
 
 - <code><a href="./src/resources/audio/transcriptions.ts">Transcription</a></code>
+- <code><a href="./src/resources/audio/transcriptions.ts">TranscriptionSegment</a></code>
+- <code><a href="./src/resources/audio/transcriptions.ts">TranscriptionVerbose</a></code>
+- <code><a href="./src/resources/audio/transcriptions.ts">TranscriptionWord</a></code>
+- <code><a href="./src/resources/audio/transcriptions.ts">TranscriptionCreateResponse</a></code>
 
 Methods:
 
-- <code title="post /audio/transcriptions">client.audio.transcriptions.<a href="./src/resources/audio/transcriptions.ts">create</a>({ ...params }) -> Transcription</code>
+- <code title="post /audio/transcriptions">client.audio.transcriptions.<a href="./src/resources/audio/transcriptions.ts">create</a>({ ...params }) -> TranscriptionCreateResponse</code>
 
 ## Translations
 
 Types:
 
 - <code><a href="./src/resources/audio/translations.ts">Translation</a></code>
+- <code><a href="./src/resources/audio/translations.ts">TranslationVerbose</a></code>
+- <code><a href="./src/resources/audio/translations.ts">TranslationCreateResponse</a></code>
 
 Methods:
 
-- <code title="post /audio/translations">client.audio.translations.<a href="./src/resources/audio/translations.ts">create</a>({ ...params }) -> Translation</code>
+- <code title="post /audio/translations">client.audio.translations.<a href="./src/resources/audio/translations.ts">create</a>({ ...params }) -> TranslationCreateResponse</code>
 
 ## Speech
 

src/resources/audio/audio.ts

@@ -25,9 +25,15 @@ export namespace Audio {
   export import AudioResponseFormat = AudioAPI.AudioResponseFormat;
   export import Transcriptions = TranscriptionsAPI.Transcriptions;
   export import Transcription = TranscriptionsAPI.Transcription;
+  export import TranscriptionSegment = TranscriptionsAPI.TranscriptionSegment;
+  export import TranscriptionVerbose = TranscriptionsAPI.TranscriptionVerbose;
+  export import TranscriptionWord = TranscriptionsAPI.TranscriptionWord;
+  export import TranscriptionCreateResponse = TranscriptionsAPI.TranscriptionCreateResponse;
   export import TranscriptionCreateParams = TranscriptionsAPI.TranscriptionCreateParams;
   export import Translations = TranslationsAPI.Translations;
   export import Translation = TranslationsAPI.Translation;
+  export import TranslationVerbose = TranslationsAPI.TranslationVerbose;
+  export import TranslationCreateResponse = TranslationsAPI.TranslationCreateResponse;
   export import TranslationCreateParams = TranslationsAPI.TranslationCreateParams;
   export import Speech = SpeechAPI.Speech;
   export import SpeechModel = SpeechAPI.SpeechModel;

src/resources/audio/index.ts

@@ -2,5 +2,19 @@
 
 export { AudioModel, AudioResponseFormat, Audio } from './audio';
 export { SpeechModel, SpeechCreateParams, Speech } from './speech';
-export { Transcription, TranscriptionCreateParams, Transcriptions } from './transcriptions';
-export { Translation, TranslationCreateParams, Translations } from './translations';
+export {
+  Transcription,
+  TranscriptionSegment,
+  TranscriptionVerbose,
+  TranscriptionWord,
+  TranscriptionCreateResponse,
+  TranscriptionCreateParams,
+  Transcriptions,
+} from './transcriptions';
+export {
+  Translation,
+  TranslationVerbose,
+  TranslationCreateResponse,
+  TranslationCreateParams,
+  Translations,
+} from './translations';

src/resources/audio/transcriptions.ts

@@ -9,7 +9,10 @@ export class Transcriptions extends APIResource {
   /**
    * Transcribes audio into the input language.
    */
-  create(body: TranscriptionCreateParams, options?: Core.RequestOptions): Core.APIPromise<Transcription> {
+  create(
+    body: TranscriptionCreateParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<TranscriptionCreateResponse> {
     return this._client.post('/audio/transcriptions', Core.multipartFormRequestOptions({ body, ...options }));
   }
 }
@@ -25,6 +28,115 @@ export interface Transcription {
   text: string;
 }
 
+export interface TranscriptionSegment {
+  /**
+   * Unique identifier of the segment.
+   */
+  id: number;
+
+  /**
+   * Average logprob of the segment. If the value is lower than -1, consider the
+   * logprobs failed.
+   */
+  avg_logprob: number;
+
+  /**
+   * Compression ratio of the segment. If the value is greater than 2.4, consider the
+   * compression failed.
+   */
+  compression_ratio: number;
+
+  /**
+   * End time of the segment in seconds.
+   */
+  end: number;
+
+  /**
+   * Probability of no speech in the segment. If the value is higher than 1.0 and the
+   * `avg_logprob` is below -1, consider this segment silent.
+   */
+  no_speech_prob: number;
+
+  /**
+   * Seek offset of the segment.
+   */
+  seek: number;
+
+  /**
+   * Start time of the segment in seconds.
+   */
+  start: number;
+
+  /**
+   * Temperature parameter used for generating the segment.
+   */
+  temperature: number;
+
+  /**
+   * Text content of the segment.
+   */
+  text: string;
+
+  /**
+   * Array of token IDs for the text content.
+   */
+  tokens: Array<number>;
+}
+
+/**
+ * Represents a verbose json transcription response returned by model, based on the
+ * provided input.
+ */
+export interface TranscriptionVerbose {
+  /**
+   * The duration of the input audio.
+   */
+  duration: string;
+
+  /**
+   * The language of the input audio.
+   */
+  language: string;
+
+  /**
+   * The transcribed text.
+   */
+  text: string;
+
+  /**
+   * Segments of the transcribed text and their corresponding details.
+   */
+  segments?: Array<TranscriptionSegment>;
+
+  /**
+   * Extracted words and their corresponding timestamps.
+   */
+  words?: Array<TranscriptionWord>;
+}
+
+export interface TranscriptionWord {
+  /**
+   * End time of the word in seconds.
+   */
+  end: number;
+
+  /**
+   * Start time of the word in seconds.
+   */
+  start: number;
+
+  /**
+   * The text content of the word.
+   */
+  word: string;
+}
+
+/**
+ * Represents a transcription response returned by model, based on the provided
+ * input.
+ */
+export type TranscriptionCreateResponse = Transcription | TranscriptionVerbose;
+
 export interface TranscriptionCreateParams {
   /**
    * The audio file object (not file name) to transcribe, in one of these formats:
@@ -80,5 +192,9 @@ export interface TranscriptionCreateParams {
 
 export namespace Transcriptions {
   export import Transcription = TranscriptionsAPI.Transcription;
+  export import TranscriptionSegment = TranscriptionsAPI.TranscriptionSegment;
+  export import TranscriptionVerbose = TranscriptionsAPI.TranscriptionVerbose;
+  export import TranscriptionWord = TranscriptionsAPI.TranscriptionWord;
+  export import TranscriptionCreateResponse = TranscriptionsAPI.TranscriptionCreateResponse;
   export import TranscriptionCreateParams = TranscriptionsAPI.TranscriptionCreateParams;
 }

src/resources/audio/translations.ts

@@ -4,12 +4,16 @@ import { APIResource } from '../../resource';
 import * as Core from '../../core';
 import * as TranslationsAPI from './translations';
 import * as AudioAPI from './audio';
+import * as TranscriptionsAPI from './transcriptions';
 
 export class Translations extends APIResource {
   /**
    * Translates audio into English.
    */
-  create(body: TranslationCreateParams, options?: Core.RequestOptions): Core.APIPromise<Translation> {
+  create(
+    body: TranslationCreateParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<TranslationCreateResponse> {
     return this._client.post('/audio/translations', Core.multipartFormRequestOptions({ body, ...options }));
   }
 }
@@ -18,6 +22,30 @@ export interface Translation {
   text: string;
 }
 
+export interface TranslationVerbose {
+  /**
+   * The duration of the input audio.
+   */
+  duration: string;
+
+  /**
+   * The language of the output translation (always `english`).
+   */
+  language: string;
+
+  /**
+   * The translated text.
+   */
+  text: string;
+
+  /**
+   * Segments of the translated text and their corresponding details.
+   */
+  segments?: Array<TranscriptionsAPI.TranscriptionSegment>;
+}
+
+export type TranslationCreateResponse = Translation | TranslationVerbose;
+
 export interface TranslationCreateParams {
   /**
    * The audio file object (not file name) translate, in one of these formats: flac,
@@ -57,5 +85,7 @@ export interface TranslationCreateParams {
 
 export namespace Translations {
   export import Translation = TranslationsAPI.Translation;
+  export import TranslationVerbose = TranslationsAPI.TranslationVerbose;
+  export import TranslationCreateResponse = TranslationsAPI.TranslationCreateResponse;
   export import TranslationCreateParams = TranslationsAPI.TranslationCreateParams;
 }