@soniox/node 2.0.3 → 2.1.0

package/dist/index.d.mts

@@ -811,12 +811,29 @@ type GenerateSpeechOptions = {
   /** Optional AbortSignal for cancellation. */
   signal?: AbortSignal | undefined;
 };
+/**
+ * A language supported by a Text-to-Speech model.
+ */
+type TtsLanguage = {
+  /** ISO language code. */
+  code: string;
+  /** Human-readable language name. */
+  name: string;
+};
+/**
+ * Voice gender metadata returned by the TTS models API.
+ */
+type TtsVoiceGender = 'male' | 'female' | 'neutral';
 /**
  * A Text-to-Speech voice.
  */
 type TtsVoice = {
   /** Unique identifier of the voice. */
   id: string;
+  /** Human-readable voice description. */
+  description: string;
+  /** Voice gender metadata. */
+  gender: TtsVoiceGender;
 };
 /**
  * A Text-to-Speech model.
@@ -828,6 +845,8 @@ type TtsModel = {
   aliased_model_id?: string | null;
   /** Name of the model. */
   name: string;
+  /** Languages supported by this model. */
+  languages: TtsLanguage[];
   /** Voices supported by this model. */
   voices: TtsVoice[];
 };
@@ -1597,6 +1616,61 @@ type RealtimeClientOptions = {
   default_session_options?: SttSessionOptions | undefined;
 };
 //#endregion
+//#region src/types/public/concurrency-limits.d.ts
+/**
+ * Live concurrency counts.
+ */
+type ConcurrencyCurrentValues = {
+  /**
+   * Current number of concurrent transcription sessions.
+   */
+  transcribe_concurrent: number;
+  /**
+   * Current number of concurrent TTS sessions.
+   */
+  tts_concurrent: number;
+};
+/**
+ * Configured concurrency limits.
+ */
+type ConcurrencyLimitValues = {
+  /**
+   * Configured transcription concurrency limit. Null means no configured limit.
+   */
+  transcribe_concurrent: number | null;
+  /**
+   * Configured TTS concurrency limit. Null means no configured limit.
+   */
+  tts_concurrent: number | null;
+};
+/**
+ * Current counts and configured limits for a concurrency scope.
+ */
+type ConcurrencyScopeValues = {
+  /**
+   * Current live concurrency counts.
+   */
+  current: ConcurrencyCurrentValues;
+  /**
+   * Configured concurrency limits.
+   */
+  limits: ConcurrencyLimitValues;
+};
+/**
+ * Current concurrent counts plus configured concurrency limits for the project
+ * and its organization. Values are region-scoped.
+ */
+type ConcurrencyLimitsResponse = {
+  /**
+   * Project-level concurrency counts and limits.
+   */
+  project: ConcurrencyScopeValues;
+  /**
+   * Organization-level concurrency counts and limits.
+   */
+  organization: ConcurrencyScopeValues;
+};
+//#endregion
 //#region src/types/public/files.d.ts
 /**
  * Raw file metadata from the API.
@@ -1659,6 +1733,23 @@ type ListFilesResponse<T> = {
    */
   next_page_cursor: string | null;
 };
+/**
+ * Total number of files, split by source.
+ */
+type FilesCountResponse = {
+  /**
+   * Number of files uploaded via the Playground.
+   */
+  playground: number;
+  /**
+   * Number of files uploaded via Public API.
+   */
+  public_api: number;
+  /**
+   * Total number of files across all sources.
+   */
+  total: number;
+};
 /**
  * File identifier - either a string ID or an object with an id property.
  */
@@ -2148,6 +2239,23 @@ type ListTranscriptionsResponse<T> = {
    */
   next_page_cursor: string | null;
 };
+/**
+ * Total number of transcriptions, split by request scope.
+ */
+type TranscriptionsCountResponse = {
+  /**
+   * Number of transcriptions created via the Playground.
+   */
+  playground: number;
+  /**
+   * Number of transcriptions created via Public API.
+   */
+  public_api: number;
+  /**
+   * Total number of transcriptions across all scopes.
+   */
+  total: number;
+};
 /**
  * Transcription identifier - either a string ID or an object with an id property.
  */
@@ -2164,12 +2272,20 @@ type TranscriptToken = {
   text: string;
   /**
    * Start time of the token in milliseconds.
+   *
+   * Present on original tokens (`translation_status` of `'original'` or
+   * `'none'`) and absent on translation tokens (`translation_status: 'translation'`),
+   * which do not carry timing.
    */
-  start_ms: number;
+  start_ms?: number;
   /**
    * End time of the token in milliseconds.
+   *
+   * Present on original tokens (`translation_status` of `'original'` or
+   * `'none'`) and absent on translation tokens (`translation_status: 'translation'`),
+   * which do not carry timing.
    */
-  end_ms: number;
+  end_ms?: number;
   /**
    * Confidence score for this token (0.0 to 1.0).
    */
@@ -2179,9 +2295,23 @@ type TranscriptToken = {
    */
   speaker?: string | null | undefined;
   /**
-   * Detected language code (if language identification was enabled).
+   * Language code for this token.
+   *
+   * For original tokens (`translation_status` of `'original'` or `'none'`)
+   * this is the spoken language. For translation tokens
+   * (`translation_status: 'translation'`) this is the target language.
+   *
+   * Present on every token whenever language identification or translation
+   * is configured.
    */
   language?: string | null | undefined;
+  /**
+   * Source language for translation tokens (`translation_status: 'translation'`).
+   *
+   * Identifies the language being translated from. Not set on original or
+   * `'none'` tokens; their language is in {@link TranscriptToken.language}.
+   */
+  source_language?: string | null | undefined;
   /**
    * Translation status for this token.
    */
@@ -2229,12 +2359,18 @@ type TranscriptSegment = {
   text: string;
   /**
    * Start time of the segment in milliseconds (from first token).
+   *
+   * Absent for translation-only segments where the underlying tokens carry
+   * no timestamps.
    */
-  start_ms: number;
+  start_ms?: number;
   /**
    * End time of the segment in milliseconds (from last token).
+   *
+   * Absent for translation-only segments where the underlying tokens carry
+   * no timestamps.
    */
-  end_ms: number;
+  end_ms?: number;
   /**
    * Speaker identifier (if speaker diarization was enabled).
    */
@@ -2308,6 +2444,452 @@ interface ISonioxTranscription {
   wait(options?: WaitOptions): Promise<ISonioxTranscription>;
 }
 //#endregion
+//#region src/types/public/translation.d.ts
+/**
+ * Shorthand specification of the translation direction(s) for
+ * {@link SonioxSttApi.translate}.
+ *
+ * Three mutually exclusive shapes:
+ *
+ * - `{ to }` — one-way translation into `to`. Source language(s) are
+ *   detected automatically.
+ * - `{ to, from }` — one-way translation from `from` to `to`. The source
+ *   language is hinted to the model.
+ * - `{ between: [a, b] }` — two-way translation between `a` and `b`.
+ *   Each side is translated into the other; speech in any third language
+ *   is passed through as-is.
+ */
+type TranslateMode = {
+  to: string;
+  from?: never;
+  between?: never;
+} | {
+  to: string;
+  from: string;
+  between?: never;
+} | {
+  between: [string, string];
+  to?: never;
+  from?: never;
+};
+/**
+ * Audio source for {@link SonioxSttApi.translate}. Exactly one of
+ * `file`, `file_id`, or `audio_url` must be provided.
+ */
+type TranslateAudioSource = {
+  /**
+   * File data to upload and translate.
+   */
+  file: UploadFileInput;
+  filename?: string | undefined;
+  file_id?: never;
+  audio_url?: never;
+} | {
+  /**
+   * ID of a previously uploaded file.
+   * @format uuid
+   */
+  file_id: string;
+  file?: never;
+  filename?: never;
+  audio_url?: never;
+} | {
+  /**
+   * URL of a publicly accessible audio file.
+   * @maxLength 4096
+   */
+  audio_url: string;
+  file?: never;
+  filename?: never;
+  file_id?: never;
+};
+/**
+ * Common (non-mode, non-source) options shared by every translate call.
+ */
+type TranslateBaseOptions = {
+  /**
+   * Speech-to-text model to use.
+   * @default 'stt-async-v4'
+   * @maxLength 32
+   */
+  model?: string | undefined;
+  /**
+   * Enable speaker diarization to identify different speakers.
+   */
+  enable_speaker_diarization?: boolean | undefined;
+  /**
+   * Additional context to improve transcription and translation accuracy.
+   */
+  context?: TranscriptionContext | undefined;
+  /**
+   * URL to receive webhook notifications when translation is completed or fails.
+   * @maxLength 256
+   */
+  webhook_url?: string | undefined;
+  /**
+   * Name of the authentication header sent with webhook notifications.
+   * @maxLength 256
+   */
+  webhook_auth_header_name?: string | undefined;
+  /**
+   * Authentication header value sent with webhook notifications.
+   * @maxLength 256
+   */
+  webhook_auth_header_value?: string | undefined;
+  /**
+   * Query parameters to append to the webhook URL.
+   */
+  webhook_query?: string | URLSearchParams | Record<string, string> | undefined;
+  /**
+   * Optional tracking identifier.
+   * @maxLength 256
+   */
+  client_reference_id?: string | undefined;
+  /**
+   * Resources to clean up after translation completes or on error/timeout.
+   */
+  cleanup?: CleanupTarget[] | undefined;
+  /**
+   * When true, waits for translation to complete before returning.
+   * @default false
+   */
+  wait?: boolean | undefined;
+  /**
+   * Options for waiting on completion.
+   */
+  wait_options?: WaitOptions | undefined;
+  /**
+   * When true (default), fetches and reshapes the translation result when
+   * `wait=true` and the job completes successfully.
+   * @default true
+   */
+  fetch_translation?: boolean | undefined;
+  /**
+   * AbortSignal to cancel the operation.
+   */
+  signal?: AbortSignal | undefined;
+  /**
+   * Timeout in milliseconds.
+   */
+  timeout_ms?: number | undefined;
+};
+/**
+ * Options for {@link SonioxSttApi.translate}.
+ *
+ * Combines a {@link TranslateMode} (the translation direction shorthand),
+ * a {@link TranslateAudioSource} (file, file_id, or audio_url), and
+ * {@link TranslateBaseOptions}.
+ */
+type TranslateOptions = TranslateMode & TranslateAudioSource & TranslateBaseOptions;
+/**
+ * A grouped pair of original speech and (optionally) its translation,
+ * derived from the underlying transcript tokens.
+ *
+ * In one-way mode every segment that originated from speech in the source
+ * language carries both `original_*` and `translation_*` fields. In two-way
+ * mode the same is true for the two configured languages; speech in a third
+ * language flows through with `translation_status: 'none'` and the
+ * translation fields are omitted.
+ */
+type TranslationSegment = {
+  /**
+   * Start time of the segment in milliseconds, taken from the first
+   * original token. Absent when the segment has no original tokens.
+   */
+  start_ms?: number;
+  /**
+   * End time of the segment in milliseconds, taken from the last
+   * original token. Absent when the segment has no original tokens.
+   */
+  end_ms?: number;
+  /**
+   * Speaker identifier (when speaker diarization is enabled).
+   */
+  speaker?: string;
+  /**
+   * Source language code.
+   *
+   * Derived from `original_tokens[0].language` when originals are present,
+   * otherwise from `translation_tokens[0].source_language`.
+   */
+  from: string;
+  /**
+   * Concatenated text of `original_tokens`.
+   */
+  original_text: string;
+  /**
+   * Original tokens (`translation_status` of `'original'` or `'none'`)
+   * for this segment, in order.
+   */
+  original_tokens: TranscriptToken[];
+  /**
+   * Target language code. Omitted when there are no translation tokens
+   * (e.g. third-language pass-through under `between`).
+   */
+  to?: string;
+  /**
+   * Concatenated text of `translation_tokens`. Omitted when there are no
+   * translation tokens.
+   */
+  translation_text?: string;
+  /**
+   * Translation tokens (`translation_status: 'translation'`) for this
+   * segment, in order. Omitted when there are no translation tokens.
+   */
+  translation_tokens?: TranscriptToken[];
+};
+/**
+ * Result of a one-way translation (`{ to }` or `{ to, from }` mode).
+ *
+ * `original_text` and `translation_text` flatten the per-segment content
+ * across the whole audio, which is useful when the caller just wants two
+ * parallel strings.
+ */
+type OneWayTranslation = {
+  mode: 'one_way';
+  /**
+   * Source language hint that was supplied via `from`. Undefined when only
+   * `to` was provided and the source language was auto-detected.
+   */
+  from?: string;
+  /**
+   * Target language code (the `to` value passed in).
+   */
+  to: string;
+  /**
+   * Total audio duration in milliseconds. Equals the largest `end_ms`
+   * across all original tokens, or `0` when there are no original tokens.
+   */
+  duration_ms: number;
+  /**
+   * Per-utterance segments in audio order.
+   */
+  segments: TranslationSegment[];
+  /**
+   * Concatenated text of every original token across all segments.
+   */
+  original_text: string;
+  /**
+   * Concatenated text of every translation token across all segments.
+   */
+  translation_text: string;
+};
+/**
+ * Result of a two-way translation (`{ between }` mode).
+ *
+ * No flat `original_text` / `translation_text` strings are exposed because
+ * which side is "original" depends on the segment. Read `segments` and
+ * filter / format per `from` / `to` as needed.
+ */
+type TwoWayTranslation = {
+  mode: 'two_way';
+  /**
+   * First configured language (the `between[0]` value).
+   */
+  language_a: string;
+  /**
+   * Second configured language (the `between[1]` value).
+   */
+  language_b: string;
+  /**
+   * Total audio duration in milliseconds. Equals the largest `end_ms`
+   * across all original tokens, or `0` when there are no original tokens.
+   */
+  duration_ms: number;
+  /**
+   * Per-utterance segments in audio order.
+   */
+  segments: TranslationSegment[];
+};
+/**
+ * Discriminated translation result returned by
+ * {@link SonioxTranslationJob.getTranslation},
+ * {@link SonioxTranslationJob.fetchTranslation}, and
+ * {@link translateFromTranscript}.
+ */
+type SonioxTranslation = OneWayTranslation | TwoWayTranslation;
+/**
+ * Mode parameter accepted by {@link translateFromTranscript}.
+ *
+ * The async `translate()` method stores this internally on the returned job;
+ * webhook handlers (and other callers that already have a transcript in hand)
+ * supply it directly.
+ */
+type TranslateFromTranscriptMode = {
+  type: 'one_way';
+  to: string;
+  from?: string;
+} | {
+  type: 'two_way';
+  language_a: string;
+  language_b: string;
+};
+/**
+ * Type contract for SonioxTranslationJob class.
+ */
+interface ISonioxTranslationJob extends ISonioxTranscription {
+  readonly transcript: ISonioxTranscript | null | undefined;
+  readonly translation: SonioxTranslation | null | undefined;
+  toJSON(): ReturnType<ISonioxTranscription['toJSON']>;
+  getTranslation(options?: {
+    force?: boolean;
+    signal?: AbortSignal;
+  }): Promise<SonioxTranslation | null>;
+  fetchTranslation(options?: {
+    force?: boolean;
+    signal?: AbortSignal;
+  }): Promise<SonioxTranslation | null>;
+  refresh(signal?: AbortSignal): Promise<ISonioxTranslationJob>;
+  wait(options?: WaitOptions): Promise<ISonioxTranslationJob>;
+}
+//#endregion
+//#region src/types/public/usage-logs.d.ts
+/**
+ * Sort order for usage logs.
+ */
+type UsageLogsSort = 'end_time_asc' | 'end_time_desc';
+/**
+ * Options for listing usage logs.
+ */
+type ListUsageLogsOptions = {
+  /**
+   * Start of the time window (inclusive), filtering by request end time.
+   * Must be an ISO 8601 timestamp in UTC.
+   *
+   * @example '2026-04-28T09:00:00Z'
+   */
+  start_time: string;
+  /**
+   * End of the time window (exclusive), filtering by request end time.
+   * Must be an ISO 8601 timestamp in UTC.
+   *
+   * @example '2026-04-29T09:00:00Z'
+   */
+  end_time: string;
+  /**
+   * Maximum number of usage log entries to return.
+   *
+   * @default 1000
+   * @minimum 1
+   * @maximum 1000
+   */
+  limit?: number | undefined;
+  /**
+   * Sort order by end_time.
+   *
+   * @default 'end_time_asc'
+   */
+  sort?: UsageLogsSort | undefined;
+  /**
+   * Pagination cursor for the next page of results.
+   */
+  cursor?: string | undefined;
+  /**
+   * AbortSignal for cancelling the request.
+   */
+  signal?: AbortSignal | undefined;
+};
+/**
+ * Per-request usage log entry.
+ */
+type SonioxUsageLog = {
+  /**
+   * Unique identifier of the request.
+   *
+   * @format uuid
+   */
+  uuid: string;
+  /**
+   * Request scope.
+   */
+  request_scope: string;
+  /**
+   * Optional tracking identifier provided by the caller.
+   */
+  client_reference_id?: string | null | undefined;
+  /**
+   * Model used for the request.
+   */
+  model: string;
+  /**
+   * UTC timestamp indicating when the request started.
+   *
+   * @format date-time
+   */
+  start_time: string;
+  /**
+   * UTC timestamp indicating when the request ended.
+   *
+   * @format date-time
+   */
+  end_time: string;
+  /**
+   * Number of input text tokens.
+   */
+  input_text_tokens: number;
+  /**
+   * Number of input audio tokens.
+   */
+  input_audio_tokens: number;
+  /**
+   * Input audio duration in milliseconds.
+   */
+  input_audio_duration_ms: number;
+  /**
+   * Number of output text tokens.
+   */
+  output_text_tokens: number;
+  /**
+   * Number of output audio tokens.
+   */
+  output_audio_tokens: number;
+  /**
+   * Output audio duration in milliseconds.
+   */
+  output_audio_duration_ms: number;
+  /**
+   * Total request cost in USD, represented as a decimal string.
+   */
+  cost_usd: string;
+  /**
+   * Input cost in USD, represented as a decimal string.
+   */
+  input_cost_usd: string;
+  /**
+   * Input text cost in USD, represented as a decimal string.
+   */
+  input_text_cost_usd: string;
+  /**
+   * Input audio cost in USD, represented as a decimal string.
+   */
+  input_audio_cost_usd: string;
+  /**
+   * Output cost in USD, represented as a decimal string.
+   */
+  output_cost_usd: string;
+  /**
+   * Output text cost in USD, represented as a decimal string.
+   */
+  output_text_cost_usd: string;
+  /**
+   * Output audio cost in USD, represented as a decimal string.
+   */
+  output_audio_cost_usd: string;
+};
+/**
+ * Response from listing usage logs.
+ */
+type ListUsageLogsResponse = {
+  /**
+   * Per-request usage log entries ordered by end_time and UUID.
+   */
+  usage_logs: SonioxUsageLog[];
+  /**
+   * Pagination cursor for the next page of results. Null if no more pages.
+   */
+  next_page_cursor: string | null;
+};
+//#endregion
 //#region src/types/public/webhooks.d.ts
 /**
  * Webhook event status values
@@ -2645,6 +3227,30 @@ declare class SonioxAuthAPI {
   createTemporaryKey(request: TemporaryApiKeyRequest, signal?: AbortSignal): Promise<TemporaryApiKeyResponse>;
 }
 //#endregion
+//#region src/async/concurrency-limits.d.ts
+declare class SonioxConcurrencyLimitsAPI {
+  private http;
+  constructor(http: HttpClient);
+  /**
+   * Retrieves current concurrency counts and configured limits.
+   *
+   * Values are region-scoped according to the client's configured REST API
+   * endpoint.
+   *
+   * @param signal - Optional AbortSignal for cancellation.
+   * @returns Current counts and configured limits for project and organization scopes.
+   * @throws {@link SonioxHttpError} On API errors.
+   *
+   * @example
+   * ```typescript
+   * const limits = await client.concurrencyLimits.get();
+   * console.log(limits.project.current.transcribe_concurrent);
+   * console.log(limits.project.limits.transcribe_concurrent);
+   * ```
+   */
+  get(signal?: AbortSignal): Promise<ConcurrencyLimitsResponse>;
+}
+//#endregion
 //#region src/async/files.d.ts
 /**
  * Uploaded file
@@ -2794,6 +3400,22 @@ declare class SonioxFilesAPI {
    * ```
    */
   list(options?: ListFilesOptions): Promise<FileListResult>;
+  /**
+   * Returns the total number of files, split by source.
+   *
+   * @param options - Optional cancellation parameters.
+   * @returns Total file counts for Playground, Public API, and all sources.
+   * @throws {@link SonioxHttpError} On API errors.
+   *
+   * @example
+   * ```typescript
+   * const counts = await client.files.count();
+   * console.log(counts.total);
+   * ```
+   */
+  count(options?: {
+    signal?: AbortSignal;
+  }): Promise<FilesCountResponse>;
   /**
    * Retrieve metadata for an uploaded file.
    *
@@ -2946,7 +3568,7 @@ declare class SonioxTranscript implements ISonioxTranscript {
  * A Transcription instance
  */
 declare class SonioxTranscription implements ISonioxTranscription {
-  private readonly _http;
+  protected readonly _http: HttpClient;
   /**
    * Unique identifier of the transcription.
    */
@@ -3138,6 +3760,48 @@ declare class SonioxTranscription implements ISonioxTranscription {
    */
   wait(options?: WaitOptions): Promise<SonioxTranscription>;
 }
+/**
+ * A translation job.
+ *
+ * Mirrors {@link SonioxTranscription}, with an additional translation mode and
+ * helpers that reshape the completed transcript into a {@link SonioxTranslation}.
+ */
+declare class SonioxTranslationJob extends SonioxTranscription implements ISonioxTranslationJob {
+  private readonly _mode;
+  /**
+   * Pre-fetched translation result. Only available when using `translate()`
+   * with `wait: true`, `fetch_translation !== false`, and the job completed
+   * successfully.
+   */
+  readonly translation: SonioxTranslation | null | undefined;
+  constructor(data: SonioxTranscriptionData, http: HttpClient, _mode: TranslateFromTranscriptMode, transcript?: SonioxTranscript | null, translation?: SonioxTranslation | null);
+  /**
+   * Retrieves and reshapes the completed transcript into a structured
+   * translation result.
+   *
+   * Returns cached translation if available. Use `force: true` to bypass the
+   * cached translation and fetch a fresh transcript from the API.
+   */
+  getTranslation(options?: {
+    force?: boolean;
+    signal?: AbortSignal;
+  }): Promise<SonioxTranslation | null>;
+  /**
+   * Alias for {@link SonioxTranslationJob.getTranslation}.
+   */
+  fetchTranslation(options?: {
+    force?: boolean;
+    signal?: AbortSignal;
+  }): Promise<SonioxTranslation | null>;
+  /**
+   * Re-fetches this translation job to get the latest status.
+   */
+  refresh(signal?: AbortSignal): Promise<SonioxTranslationJob>;
+  /**
+   * Waits for the translation job to complete or fail.
+   */
+  wait(options?: WaitOptions): Promise<SonioxTranslationJob>;
+}
 /**
  * Result set for transcription listing.
  */
@@ -3233,6 +3897,20 @@ declare class SonioxSttApi {
    * ```
    */
   list(options?: ListTranscriptionsOptions, signal?: AbortSignal): Promise<TranscriptionListResult>;
+  /**
+   * Returns the total number of transcriptions, split by request scope.
+   *
+   * @param signal - Optional AbortSignal for request cancellation.
+   * @returns Total transcription counts for Playground, Public API, and all scopes.
+   * @throws {@link SonioxHttpError} On API errors.
+   *
+   * @example
+   * ```typescript
+   * const counts = await client.stt.count();
+   * console.log(counts.total);
+   * ```
+   */
+  count(signal?: AbortSignal): Promise<TranscriptionsCountResponse>;
   /**
    * Retrieves a transcription by ID
    *
@@ -3416,6 +4094,67 @@ declare class SonioxSttApi {
    * ```
    */
   transcribe(options: TranscribeOptions): Promise<SonioxTranscription>;
+  /**
+   * Starts a translation job.
+   *
+   * Sugar around {@link SonioxSttApi.transcribe}: configures translation from
+   * the supplied {@link TranslateMode} (`{ to }`, `{ to, from }`, or
+   * `{ between }`) and returns a {@link SonioxTranslationJob}. With
+   * `wait: true`, waits for completion before returning, mirroring
+   * {@link SonioxSttApi.transcribe}.
+   *
+   * Method-owned fields (cannot be set by the caller):
+   * - `translation` — derived from `to` / `between`.
+   * - `language_hints` + `language_hints_strict: true` — derived from
+   *   `from` / `between`.
+   * - `enable_language_identification: true` — always. The reshape step
+   *   relies on every token carrying a `language` field to group originals
+   *   with their translations.
+   * - `fetch_transcript` — derived from `fetch_translation` when `wait=true`.
+   *
+   * @param options - Mode, audio source, and pass-through options.
+   * @returns The translation job.
+   * @throws {@link SonioxHttpError} On API errors.
+   * @throws `Error` On validation errors or wait timeout.
+   *
+   * @example
+   * ```typescript
+   * // One-way: detect any source language, translate to Spanish.
+   * const job = await client.stt.translate({
+   *     audio_url: 'https://soniox.com/media/examples/coffee_shop.mp3',
+   *     to: 'es',
+   * });
+   *
+   * const completed = await job.wait();
+   * const result = await completed.getTranslation();
+   * console.log(result?.translation_text);
+   *
+   * // One-way with explicit source language.
+   * const explicitJob = await client.stt.translate({
+   *     file: buffer,
+   *     filename: 'meeting.mp3',
+   *     from: 'en',
+   *     to: 'es',
+   *     wait: true,
+   * });
+   * console.log(explicitJob.translation?.translation_text);
+   *
+   * // Two-way: bidirectional translation between two languages.
+   * const twoWayJob = await client.stt.translate({
+   *     audio_url: 'https://soniox.com/media/examples/coffee_shop.mp3',
+   *     between: ['en', 'es'],
+   *     enable_speaker_diarization: true,
+   *     wait: true,
+   * });
+   * for (const seg of twoWayJob.translation?.segments ?? []) {
+   *     console.log(`[${seg.from}] ${seg.original_text}`);
+   *     if (seg.translation_text) {
+   *         console.log(`  → [${seg.to}] ${seg.translation_text}`);
+   *     }
+   * }
+   * ```
+   */
+  translate(options: TranslateOptions): Promise<SonioxTranslationJob>;
   /**
    * Permanently deletes all transcriptions.
    * Iterates through all pages of transcriptions and deletes each one.
@@ -3513,6 +4252,65 @@ declare class SonioxTtsApi extends TtsRestClient {
   listModels(signal?: AbortSignal): Promise<TtsModel[]>;
 }
 //#endregion
+//#region src/async/usage-logs.d.ts
+/**
+ * Result set for usage log listing.
+ */
+declare class UsageLogListResult implements AsyncIterable<SonioxUsageLog> {
+  private readonly _http;
+  private readonly _options;
+  /**
+   * Usage logs from the first page of results.
+   */
+  readonly usage_logs: SonioxUsageLog[];
+  /**
+   * Pagination cursor for the next page. Null if no more pages.
+   */
+  readonly next_page_cursor: string | null;
+  constructor(initialResponse: ListUsageLogsResponse, _http: HttpClient, _options: ListUsageLogsOptions);
+  /**
+   * Returns the raw data for this list result.
+   */
+  toJSON(): ListUsageLogsResponse;
+  /**
+   * Returns true if there are more pages of results beyond the first page.
+   */
+  isPaged(): boolean;
+  /**
+   * Async iterator that automatically fetches all pages.
+   * Use with `for await...of` to iterate through all usage logs.
+   */
+  [Symbol.asyncIterator](): AsyncIterator<SonioxUsageLog>;
+}
+declare class SonioxUsageLogsAPI {
+  private http;
+  constructor(http: HttpClient);
+  /**
+   * Retrieves per-request usage log entries for the project.
+   *
+   * The returned result is async iterable. Use `for await...of` to iterate
+   * through all pages.
+   *
+   * @param options - Required time window plus optional pagination, sorting, and cancellation.
+   * @returns UsageLogListResult with async iteration support.
+   * @throws {@link SonioxHttpError} On API errors.
+   *
+   * @example
+   * ```typescript
+   * const result = await client.usageLogs.list({
+   *   start_time: '2026-04-28T09:00:00Z',
+   *   end_time: '2026-04-29T09:00:00Z',
+   *   sort: 'end_time_desc',
+   * });
+   *
+   * for await (const log of result) {
+   *   console.log(log.model, log.cost_usd);
+   * }
+   * ```
+   */
+  list(options: ListUsageLogsOptions): Promise<UsageLogListResult>;
+}
+//#endregion
 //#region src/async/webhooks.d.ts
 /**
  * Webhook utilities API accessible via client.webhooks
@@ -3722,6 +4520,8 @@ declare class SonioxNodeClient {
   readonly models: SonioxModelsAPI;
   readonly webhooks: SonioxWebhooksAPI;
   readonly auth: SonioxAuthAPI;
+  readonly concurrencyLimits: SonioxConcurrencyLimitsAPI;
+  readonly usageLogs: SonioxUsageLogsAPI;
   readonly realtime: SonioxRealtimeApi;
   constructor(options?: SonioxNodeClientOptions);
 }
@@ -3824,5 +4624,38 @@ declare function normalizeHeaders(headers: Headers): Record<string, string>;
  */
 declare function mergeHeaders(...headerObjects: (Record<string, string> | undefined)[]): Record<string, string>;
 //#endregion
-export { AbortError, type AudioData, type AudioFormat, AuthError, BadRequestError, type CleanupTarget, ConnectionError, type ContextGeneralEntry, type ContextTranslationTerm, type CreateTranscriptionOptions, type DeleteAllFilesOptions, type DeleteAllTranscriptionsOptions, type ExpressLikeRequest, type FastifyLikeRequest, FetchHttpClient, type FileIdentifier, FileListResult, type GenerateSpeechOptions, type HandleWebhookOptions, type HonoLikeContext, type HttpClient, type HttpClientOptions, type HttpErrorCode, type HttpErrorDetails, type HttpMethod, type HttpObservabilityHooks, type HttpRequest, type HttpRequestBody, type HttpRequestMeta, type HttpResponse, type HttpResponseMeta, type HttpResponseType, type ISonioxTranscript, type ISonioxTranscription, type ListFilesOptions, type ListFilesResponse, type ListTranscriptionsOptions, type ListTranscriptionsResponse, type NestJSLikeRequest, NetworkError, type OneWayTranslationConfig, type QueryParams, QuotaError, type RealtimeClientOptions, RealtimeError, type RealtimeErrorCode, type RealtimeEvent, RealtimeOptions, type RealtimeResult, type RealtimeSegment, RealtimeSegmentBuffer, type RealtimeSegmentBufferOptions, type RealtimeSegmentOptions, RealtimeSttSession, type RealtimeToken, RealtimeTtsConnection, RealtimeTtsStream, type RealtimeUtterance, RealtimeUtteranceBuffer, type RealtimeUtteranceBufferOptions, type ResolvedConnectionConfig, SONIOX_API_BASE_URL, SONIOX_API_WEBHOOK_HEADER_ENV, SONIOX_API_WEBHOOK_SECRET_ENV, SONIOX_API_WS_URL, SONIOX_TMP_API_KEY_DURATION_MAX, SONIOX_TMP_API_KEY_DURATION_MIN, SONIOX_TMP_API_KEY_USAGE_TYPE, SONIOX_TTS_API_BASE_URL, SONIOX_TTS_WS_URL, type SegmentGroupKey, type SegmentTranscriptOptions, type SendStreamOptions, type SonioxConnectionConfig, SonioxError, type SonioxErrorCode, SonioxFile, type SonioxFileData, SonioxHttpError, type SonioxLanguage, type SonioxModel, SonioxNodeClient, SonioxNodeClientOptions, SonioxRealtimeApi, type SonioxRegion, SonioxTranscript, SonioxTranscription, type SonioxTranscriptionData, type SonioxTranscriptionMode, type SonioxTranslationTarget, SonioxTtsApi, StateError, type SttSessionConfig, type SttSessionEvents, type SttSessionOptions, type SttSessionState, TemporaryApiKeyRequest, TemporaryApiKeyResponse, TemporaryApiKeyUsageType, type TranscribeBaseOptions, type TranscribeFromFile, type TranscribeFromFileId, type TranscribeFromFileIdOptions, type TranscribeFromFileOptions, type TranscribeFromUrl, type TranscribeFromUrlOptions, type TranscribeOptions, type TranscriptResponse, type TranscriptSegment, type TranscriptToken, type TranscriptionContext, type TranscriptionIdentifier, TranscriptionListResult, type TranscriptionStatus, type TranslationConfig, type TtsAudioFormat, type TtsConnectionEvents, type TtsConnectionOptions, type TtsEvent, type TtsModel, type TtsStreamConfig, type TtsStreamEvents, type TtsStreamInput, type TtsStreamState, type TtsVoice, type TwoWayTranslationConfig, type UploadFileInput, type UploadFileOptions, type WaitOptions, type WebhookAuthConfig, type WebhookEvent, type WebhookEventStatus, type WebhookHandlerResult, type WebhookHandlerResultWithFetch, type WebhookHeaders, buildUrl, createAbortError, createHttpError, createNetworkError, createParseError, createTimeoutError, isAbortError, isSonioxError, isSonioxHttpError, mergeHeaders, normalizeHeaders, resolveConnectionConfig, segmentRealtimeTokens, segmentTranscript };
+//#region src/async/translation.d.ts
+/**
+ * A tokens-bearing transcript-shaped object accepted by
+ * {@link translateFromTranscript}.
+ */
+type TranscriptLike = ISonioxTranscript | TranscriptResponse | {
+  tokens: TranscriptToken[];
+};
+/**
+ * Reshape a transcript produced by a translation-enabled transcription into a
+ * structured {@link SonioxTranslation} result.
+ *
+ * This is the same logic `SonioxTranslationJob.getTranslation()` applies.
+ * Use it directly in webhook handlers or anywhere else you already have a
+ * transcript in hand.
+ *
+ * @param transcript - Transcript (or any object with a `tokens` array) emitted
+ *   for a translation-enabled transcription.
+ * @param mode - Whether to reshape as one-way or two-way; the discriminator
+ *   tells the helper which result shape to produce.
+ * @returns A {@link SonioxTranslation} keyed on `mode`.
+ *
+ * @example
+ * ```typescript
+ * import { translateFromTranscript } from '@soniox/node';
+ *
+ * // From a webhook handler that just received the transcript
+ * const result = translateFromTranscript(transcript, { type: 'one_way', to: 'es' });
+ * console.log(result.translation_text);
+ * ```
+ */
+declare function translateFromTranscript(transcript: TranscriptLike, mode: TranslateFromTranscriptMode): SonioxTranslation;
+//#endregion
+export { AbortError, type AudioData, type AudioFormat, AuthError, BadRequestError, type CleanupTarget, type ConcurrencyCurrentValues, type ConcurrencyLimitValues, type ConcurrencyLimitsResponse, type ConcurrencyScopeValues, ConnectionError, type ContextGeneralEntry, type ContextTranslationTerm, type CreateTranscriptionOptions, type DeleteAllFilesOptions, type DeleteAllTranscriptionsOptions, type ExpressLikeRequest, type FastifyLikeRequest, FetchHttpClient, type FileIdentifier, FileListResult, type FilesCountResponse, type GenerateSpeechOptions, type HandleWebhookOptions, type HonoLikeContext, type HttpClient, type HttpClientOptions, type HttpErrorCode, type HttpErrorDetails, type HttpMethod, type HttpObservabilityHooks, type HttpRequest, type HttpRequestBody, type HttpRequestMeta, type HttpResponse, type HttpResponseMeta, type HttpResponseType, type ISonioxTranscript, type ISonioxTranscription, type ISonioxTranslationJob, type ListFilesOptions, type ListFilesResponse, type ListTranscriptionsOptions, type ListTranscriptionsResponse, type ListUsageLogsOptions, type ListUsageLogsResponse, type NestJSLikeRequest, NetworkError, type OneWayTranslation, type OneWayTranslationConfig, type QueryParams, QuotaError, type RealtimeClientOptions, RealtimeError, type RealtimeErrorCode, type RealtimeEvent, RealtimeOptions, type RealtimeResult, type RealtimeSegment, RealtimeSegmentBuffer, type RealtimeSegmentBufferOptions, type RealtimeSegmentOptions, RealtimeSttSession, type RealtimeToken, RealtimeTtsConnection, RealtimeTtsStream, type RealtimeUtterance, RealtimeUtteranceBuffer, type RealtimeUtteranceBufferOptions, type ResolvedConnectionConfig, SONIOX_API_BASE_URL, SONIOX_API_WEBHOOK_HEADER_ENV, SONIOX_API_WEBHOOK_SECRET_ENV, SONIOX_API_WS_URL, SONIOX_TMP_API_KEY_DURATION_MAX, SONIOX_TMP_API_KEY_DURATION_MIN, SONIOX_TMP_API_KEY_USAGE_TYPE, SONIOX_TTS_API_BASE_URL, SONIOX_TTS_WS_URL, type SegmentGroupKey, type SegmentTranscriptOptions, type SendStreamOptions, SonioxConcurrencyLimitsAPI, type SonioxConnectionConfig, SonioxError, type SonioxErrorCode, SonioxFile, type SonioxFileData, SonioxHttpError, type SonioxLanguage, type SonioxModel, SonioxNodeClient, SonioxNodeClientOptions, SonioxRealtimeApi, type SonioxRegion, SonioxTranscript, SonioxTranscription, type SonioxTranscriptionData, type SonioxTranscriptionMode, type SonioxTranslation, SonioxTranslationJob, type SonioxTranslationTarget, SonioxTtsApi, type SonioxUsageLog, SonioxUsageLogsAPI, StateError, type SttSessionConfig, type SttSessionEvents, type SttSessionOptions, type SttSessionState, TemporaryApiKeyRequest, TemporaryApiKeyResponse, TemporaryApiKeyUsageType, type TranscribeBaseOptions, type TranscribeFromFile, type TranscribeFromFileId, type TranscribeFromFileIdOptions, type TranscribeFromFileOptions, type TranscribeFromUrl, type TranscribeFromUrlOptions, type TranscribeOptions, type TranscriptResponse, type TranscriptSegment, type TranscriptToken, type TranscriptionContext, type TranscriptionIdentifier, TranscriptionListResult, type TranscriptionStatus, type TranscriptionsCountResponse, type TranslateAudioSource, type TranslateBaseOptions, type TranslateFromTranscriptMode, type TranslateMode, type TranslateOptions, type TranslationConfig, type TranslationSegment, type TtsAudioFormat, type TtsConnectionEvents, type TtsConnectionOptions, type TtsEvent, type TtsLanguage, type TtsModel, type TtsStreamConfig, type TtsStreamEvents, type TtsStreamInput, type TtsStreamState, type TtsVoice, type TtsVoiceGender, type TwoWayTranslation, type TwoWayTranslationConfig, type UploadFileInput, type UploadFileOptions, UsageLogListResult, type UsageLogsSort, type WaitOptions, type WebhookAuthConfig, type WebhookEvent, type WebhookEventStatus, type WebhookHandlerResult, type WebhookHandlerResultWithFetch, type WebhookHeaders, buildUrl, createAbortError, createHttpError, createNetworkError, createParseError, createTimeoutError, isAbortError, isSonioxError, isSonioxHttpError, mergeHeaders, normalizeHeaders, resolveConnectionConfig, segmentRealtimeTokens, segmentTranscript, translateFromTranscript };
 //# sourceMappingURL=index.d.mts.map