openai 7.10.0 → 7.13.0

package/src/lib/responses/ResponseInputItems.ts

@@ -15,7 +15,8 @@ type ResponseAdditionalToolsInputItem = Extract<ResponseInputItem, { type: 'addi
 /**
  * Normalizes a mixed array of stored response history items into clean
  * `ResponseInputItem`s that can be sent back to `responses.create()`. Known items
- * that cannot be replayed without changing their meaning are omitted.
+ * that cannot be replayed without changing their meaning are omitted. SDK-only
+ * parsed values are removed without changing the stored items.
  *
  * @throws {TypeError} If an item type is not supported by the installed SDK.
  */
@@ -33,12 +34,38 @@ export function toResponseInputItems(items: Iterable<ResponseInputItemLike>): Re
 /**
  * Normalizes a stored response history item into a clean `ResponseInputItem`, or
  * returns `null` when a known item cannot be replayed without changing its
- * meaning.
+ * meaning. SDK-only parsed values are removed without changing the stored item.
  *
  * @throws {TypeError} If the item type is not supported by the installed SDK.
  */
 export function toResponseInputItem(item: ResponseInputItemLike): ResponseInputItem | null {
   switch (item.type) {
+    case 'message': {
+      if (item.role !== 'assistant' || !('id' in item) || !Array.isArray(item.content)) {
+        return stripCreatedBy(item);
+      }
+      const content = item.content.map((part) => {
+        if ((part.type === 'output_text' || part.type === 'refusal') && 'parsed' in part) {
+          const { parsed: _parsed, ...inputPart } = part;
+          return inputPart;
+        }
+        return part;
+      });
+      if (content.every((part, index) => part === item.content[index])) {
+        return stripCreatedBy(item);
+      }
+      return { ...stripCreatedBy(item), content };
+    }
+
+    case 'function_call': {
+      const inputItem = stripCreatedBy(item);
+      if (!('parsed_arguments' in inputItem)) {
+        return inputItem;
+      }
+      const { parsed_arguments: _parsedArguments, ...withoutParsedArguments } = inputItem;
+      return withoutParsedArguments;
+    }
+
     case 'additional_tools': {
       if (item.role !== 'developer') {
         return null;
@@ -87,7 +114,6 @@ export function toResponseInputItem(item: ResponseInputItemLike): ResponseInputI
     case 'configuration_update':
     case 'custom_tool_call':
     case 'file_search_call':
-    case 'function_call':
     case 'function_call_output':
     case 'image_generation_call':
     case 'item_reference':
@@ -97,7 +123,6 @@ export function toResponseInputItem(item: ResponseInputItemLike): ResponseInputI
     case 'mcp_approval_response':
     case 'mcp_call':
     case 'mcp_list_tools':
-    case 'message':
     case 'program':
     case 'program_output':
     case 'reasoning':

package/src/lib/transform.ts

@@ -70,6 +70,7 @@ const JSON_SCHEMA_UNSUPPORTED_SCHEMA_KEYWORDS = new Set([
   'minContains',
   'minProperties',
   'not',
+  'oneOf',
   'patternProperties',
   'prefixItems',
   'propertyNames',

package/src/lib/vector-store-polling.ts

@@ -6,8 +6,8 @@ import { pollWithResponse } from './polling';
 type PollOptions = RequestOptions & { pollIntervalMs?: number };
 
 /**
- * Polls an attached file through the resource's retrieve method. Failed files are
- * returned to the caller, and cancelled files retain their existing retry behavior.
+ * Polls an attached file through the resource's retrieve method until it completes,
+ * fails, or is cancelled. Retrieval errors are propagated unchanged.
  *
  * @internal
  */
@@ -20,7 +20,7 @@ export function pollVectorStoreFile(
   return pollWithResponse(
     (headers) => resource.retrieve(fileID, { vector_store_id: vectorStoreID }, { ...options, headers }),
     ['in_progress'],
-    ['failed', 'completed'],
+    ['failed', 'cancelled', 'completed'],
     options,
   );
 }

package/src/lib/vector-store-upload.ts

@@ -8,7 +8,8 @@ type UploadOptions = RequestOptions & { pollIntervalMs?: number; maxConcurrency?
 
 /**
  * Uploads files with a shared iterator, then creates and polls the batch. Every
- * worker settles before upload failures are propagated.
+ * worker settles before upload failures are propagated. Zero concurrency is
+ * rejected before any upload or batch-creation request.
  *
  * @internal
  */
@@ -28,6 +29,9 @@ export async function uploadAndPollVectorStoreFileBatch(
 
   const configuredConcurrency = options?.maxConcurrency ?? 5;
   const concurrencyLimit = Math.min(configuredConcurrency, files.length);
+  if (concurrencyLimit === 0) {
+    throw new RangeError('maxConcurrency must be greater than 0');
+  }
   const fileIterator = files.values();
   const allFileIds = [...fileIds];
 

package/src/providers/bedrock/aws.ts

@@ -7,9 +7,9 @@ import type { BodyInit } from '../../internal/builtin-types';
 import {
   assertBedrockRequestOrigin,
   assertProviderOwnsAuthorization,
-  errorWithCause,
   normalizeOptionalString,
   parseBedrockEndpointHostname,
+  prepareBedrockAuth,
   resolveBedrockBearerAuth,
   resolveBedrockEndpoint,
 } from '../../internal/bedrock';
@@ -115,7 +115,7 @@ function requestTarget(parsedURL: URL): { path: string; query: Record<string, st
     } else if (typeof existing === 'string') {
       query[name] = [existing, value];
     } else {
-      query[name] = [...existing, value];
+      existing.push(value);
     }
   }
   return { path: parsedURL.pathname, query };
@@ -194,14 +194,14 @@ class BedrockSigV4Auth implements BedrockRequestAuth {
     }));
   }
 
-  async prepareRequest(request: FinalizedRequestInit, { url }: ProviderRequestContext): Promise<void> {
+  async prepareRequest(request: FinalizedRequestInit, context: ProviderRequestContext): Promise<void> {
     if (Object.prototype.toString.call((globalThis as any).process) !== '[object process]') {
       throw new Errors.OpenAIError(
         'Bedrock AWS credential authentication is only supported in Node.js and compatible server runtimes. Use bearer authentication in this runtime.',
       );
     }
 
-    const parsedURL = new URL(url);
+    const parsedURL = new URL(context.url);
     const canonicalEndpoint = parseBedrockEndpointHostname(parsedURL.hostname);
     if (canonicalEndpoint && canonicalEndpoint.endpoint !== this.options.endpoint) {
       throw new Errors.OpenAIError(
@@ -225,27 +225,26 @@ class BedrockSigV4Auth implements BedrockRequestAuth {
     const body = signableBody(request.body);
     const target = requestTarget(parsedURL);
 
-    let signed: { headers: Record<string, string> };
-    try {
-      signed = await this.signatureV4().sign({
-        protocol: parsedURL.protocol,
-        hostname: parsedURL.hostname,
-        ...(parsedURL.port ? { port: Number(parsedURL.port) } : {}),
-        method,
-        ...target,
-        headers: Object.fromEntries(headers.entries()),
-        ...(body === undefined ? {} : { body }),
-      });
-    } catch (cause) {
-      const message = this.options.usesDefaultChain
+    await prepareBedrockAuth(request, context, {
+      resolve: () =>
+        this.signatureV4().sign({
+          protocol: parsedURL.protocol,
+          hostname: parsedURL.hostname,
+          ...(parsedURL.port ? { port: Number(parsedURL.port) } : {}),
+          method,
+          ...target,
+          headers: Object.fromEntries(headers.entries()),
+          ...(body === undefined ? {} : { body }),
+        }),
+      failureMessage: this.options.usesDefaultChain
         ? 'Could not find credentials for Bedrock. Pass AWS credentials to `bedrock(...)` or configure the default AWS credential chain.'
-        : 'Failed to resolve AWS credentials for Bedrock. Verify your AWS profile, environment variables, or runtime identity configuration and try again.';
-      throw errorWithCause(message, cause);
-    }
-
-    request.method = method;
-    request.redirect = 'manual';
-    request.headers = new Headers(signed.headers);
+        : 'Failed to resolve AWS credentials for Bedrock. Verify your AWS profile, environment variables, or runtime identity configuration and try again.',
+      apply: (signed) => {
+        request.method = method;
+        request.redirect = 'manual';
+        request.headers = new Headers(signed.headers);
+      },
+    });
   }
 }
 

package/src/realtime/internal-base.ts

@@ -281,19 +281,17 @@ export function buildRealtimeURL(
     return url;
   }
 
-  let url: URL;
+  const url = new URL(baseURL);
   if (azure) {
-    url = new URL(baseURL);
     const basePath = url.pathname.replace(/\/+/g, '/').replace(/\/+$/, '');
     const versionedPath = basePath.endsWith('/v1') ? basePath : `${basePath}/v1`;
     url.pathname = `${versionedPath}/realtime`;
     url.search = '';
-    url.hash = '';
   } else {
-    const path = '/realtime';
-    url = new URL(baseURL + (baseURL.endsWith('/') ? path.slice(1) : path));
+    url.pathname += url.pathname.endsWith('/') ? 'realtime' : '/realtime';
   }
 
+  url.hash = '';
   url.protocol = 'wss';
   // Sideband control connections attach to an existing call via `call_id`.
   if (hasCallID) {

package/src/realtime/websocket.ts

@@ -1,3 +1,4 @@
+import { getRealtimeAPIKey, resolveRealtimeAPIKey } from '../internal/realtime-credentials';
 import type { AzureOpenAI } from '../index';
 import { assertBedrockWebSocketOrigin } from '../internal/bedrock';
 import { OpenAI } from '../index';
@@ -175,15 +176,18 @@ export class OpenAIRealtimeWebSocket extends OpenAIRealtimeEmitter {
       onURL?: (url: URL) => void;
       /** Indicates the token was resolved by the factory just before connecting. @internal */
       __resolvedApiKey?: boolean;
+      /** Credential captured by an async factory for this connection. @internal */
+      __apiKey?: string | null;
     },
     client?: Pick<OpenAI, 'apiKey' | 'baseURL'>,
   ) {
     super();
+    let apiKey = getRealtimeAPIKey(client, props.__apiKey);
     const hasProvider = typeof (client as any)?._options?.apiKey === 'function';
     const dangerouslyAllowBrowser =
       props.dangerouslyAllowBrowser ??
       (client as any)?._options?.dangerouslyAllowBrowser ??
-      (client?.apiKey?.startsWith('ek_') ? true : null);
+      (apiKey?.startsWith('ek_') ? true : null);
     if (!dangerouslyAllowBrowser && isRunningInBrowserOrBrowserWorker()) {
       throw new OpenAIError(
         "It looks like you're running in a browser-like environment.\n\nThis is disabled by default, as it risks exposing your secret API credentials to attackers.\n\nYou can avoid this error by creating an ephemeral session token:\nhttps://platform.openai.com/docs/api-reference/realtime-sessions\n",
@@ -191,6 +195,9 @@ export class OpenAIRealtimeWebSocket extends OpenAIRealtimeEmitter {
     }
 
     client ??= new OpenAI({ dangerouslyAllowBrowser });
+    if (apiKey === undefined) {
+      apiKey = client.apiKey;
+    }
 
     if (hasProvider && !props?.__resolvedApiKey) {
       throw new Error(
@@ -209,10 +216,10 @@ export class OpenAIRealtimeWebSocket extends OpenAIRealtimeEmitter {
     assertBedrockWebSocketOrigin(client, this.url);
 
     const azure = isAzure(client);
-    const protocols = ['realtime', ...(azure ? [] : [`openai-insecure-api-key.${client.apiKey}`])];
+    const protocols = ['realtime', ...(azure ? [] : [`openai-insecure-api-key.${apiKey}`])];
 
     this.socket = azure
-      ? createAzureWebSocket(this.url, client.apiKey, props.__resolvedApiKey === true, protocols)
+      ? createAzureWebSocket(this.url, apiKey, props.__resolvedApiKey === true, protocols)
       : new WebSocket(this.url.toString(), protocols);
 
     this.socket.addEventListener('message', (websocketEvent: MessageEvent) => {
@@ -269,7 +276,7 @@ export class OpenAIRealtimeWebSocket extends OpenAIRealtimeEmitter {
       dangerouslyAllowBrowser?: boolean;
     },
   ): Promise<OpenAIRealtimeWebSocket> {
-    const resolvedApiKey = await client._callApiKey();
+    const { apiKey, isProvider: resolvedApiKey } = await resolveRealtimeAPIKey(client);
     const url = buildRealtimeURL(client, props);
     assertBedrockWebSocketOrigin(client, url);
     return new OpenAIRealtimeWebSocket(
@@ -277,6 +284,7 @@ export class OpenAIRealtimeWebSocket extends OpenAIRealtimeEmitter {
         ...props,
         buildRealtimeURL: () => url,
         __resolvedApiKey: resolvedApiKey,
+        __apiKey: apiKey,
       },
       client,
     );
@@ -301,8 +309,7 @@ export class OpenAIRealtimeWebSocket extends OpenAIRealtimeEmitter {
     } = {},
   ): Promise<OpenAIRealtimeWebSocket> {
     const connection = getAzureRealtimeConnection(client, options);
-    const isApiKeyProvider = await client._callApiKey();
-    const apiKey = client.apiKey;
+    const { apiKey, isProvider: isApiKeyProvider } = await resolveRealtimeAPIKey(client);
     if (!apiKey) {
       throw new Error('Azure OpenAI Realtime requires an API key');
     }
@@ -312,6 +319,7 @@ export class OpenAIRealtimeWebSocket extends OpenAIRealtimeEmitter {
         ...connection,
         ...(dangerouslyAllowBrowser === undefined ? {} : { dangerouslyAllowBrowser }),
         __resolvedApiKey: isApiKeyProvider,
+        __apiKey: apiKey,
       },
       client,
     );

package/src/realtime/ws.ts

@@ -1,3 +1,4 @@
+import { resolveRealtimeAPIKey } from '../internal/realtime-credentials';
 import * as WS from 'ws';
 import { assertBedrockWebSocketOrigin } from '../internal/bedrock';
 import { protectWebSocketOptionsFromCredentialRedirects } from '../internal/ws';
@@ -46,11 +47,14 @@ export class OpenAIRealtimeWS extends OpenAIRealtimeEmitter {
 
       /** Indicates that a function-based credential was resolved by an async factory. @internal */
       __resolvedApiKey?: boolean;
+      /** Credential captured by an async factory for this connection. @internal */
+      __apiKey?: string | null;
     },
     client?: Pick<OpenAI, 'apiKey' | 'baseURL'>,
   ) {
     super();
     client ??= new OpenAI();
+    const apiKey = props.__apiKey === undefined ? client.apiKey : props.__apiKey;
     const hasProvider = typeof (client as any)?._options?.apiKey === 'function';
     if (hasProvider && !props.__resolvedApiKey) {
       throw new Error(
@@ -65,7 +69,7 @@ export class OpenAIRealtimeWS extends OpenAIRealtimeEmitter {
     const headers = {
       'User-Agent': `${client.constructor.name}/JS ${VERSION}`,
       ...props.options?.headers,
-      ...(isAzure(client) && !props.__resolvedApiKey ? {} : { Authorization: `Bearer ${client.apiKey}` }),
+      ...(isAzure(client) && !props.__resolvedApiKey ? {} : { Authorization: `Bearer ${apiKey}` }),
     };
 
     this.socket = new WS.WebSocket(
@@ -130,7 +134,7 @@ export class OpenAIRealtimeWS extends OpenAIRealtimeEmitter {
       options?: WS.ClientOptions | undefined;
     },
   ): Promise<OpenAIRealtimeWS> {
-    const resolvedApiKey = await client._callApiKey();
+    const { apiKey, isProvider: resolvedApiKey } = await resolveRealtimeAPIKey(client);
     const url = buildRealtimeURL(client, props);
     assertBedrockWebSocketOrigin(client, url);
     return new OpenAIRealtimeWS(
@@ -138,6 +142,7 @@ export class OpenAIRealtimeWS extends OpenAIRealtimeEmitter {
         ...props,
         buildRealtimeURL: () => url,
         __resolvedApiKey: resolvedApiKey,
+        __apiKey: apiKey,
       },
       client,
     );
@@ -162,8 +167,7 @@ export class OpenAIRealtimeWS extends OpenAIRealtimeEmitter {
     } = {},
   ): Promise<OpenAIRealtimeWS> {
     const connection = getAzureRealtimeConnection(client, props);
-    const isApiKeyProvider = await client._callApiKey();
-    const apiKey = client.apiKey;
+    const { apiKey, isProvider: isApiKeyProvider } = await resolveRealtimeAPIKey(client);
     if (!apiKey) {
       throw new Error('Azure OpenAI Realtime requires an API key');
     }
@@ -178,6 +182,7 @@ export class OpenAIRealtimeWS extends OpenAIRealtimeEmitter {
           },
         },
         __resolvedApiKey: isApiKeyProvider,
+        __apiKey: apiKey,
       },
       client,
     );

package/src/resources/admin/organization/audit-logs.ts

@@ -1860,7 +1860,7 @@ export interface AuditLogListParams extends ConversationCursorPageParams {
   /**
    * Return only events with a `type` in one of these values. For example,
    * `project.created`. For all options, see the documentation for the
-   * [audit log object](https://platform.openai.com/docs/api-reference/audit-logs/object).
+   * [audit log object](https://developers.openai.com/api/reference/resources/admin/subresources/organization/subresources/audit_logs).
    */
   event_types?: Array<
     | 'api_key.created'

package/src/resources/admin/organization/projects/api-keys.ts

@@ -130,6 +130,12 @@ export interface ProjectAPIKey {
    * The redacted value of the API key
    */
   redacted_value: string;
+
+  /**
+   * The Unix timestamp (in seconds) when the API key expires, or null if it does not
+   * expire.
+   */
+  expires_at?: number | null;
 }
 
 export namespace ProjectAPIKey {

package/src/resources/admin/organization/projects/projects.ts

@@ -313,7 +313,7 @@ export interface ProjectCreateParams {
    * @deprecated Create the project with the specified data residency region. Your
    * organization must have access to Data residency functionality in order to use.
    * See
-   * [data residency controls](https://platform.openai.com/docs/guides/your-data#data-residency-controls)
+   * [data residency controls](https://developers.openai.com/api/docs/guides/your-data#data-residency-controls)
    * to review the functionality and limitations of setting this field. Deprecated:
    * use `residency` instead. Do not provide both `geography` and `residency`.
    */
@@ -323,7 +323,7 @@ export interface ProjectCreateParams {
    * Create the project with the specified residency configuration. Your organization
    * must have access to the requested residency configuration in order to use it.
    * See
-   * [data residency controls](https://platform.openai.com/docs/guides/your-data#data-residency-controls)
+   * [data residency controls](https://developers.openai.com/api/docs/guides/your-data#data-residency-controls)
    * to review the functionality and limitations of setting this field.
    */
   residency?: ProjectResidency | null;

package/src/resources/admin/organization/projects/service-accounts/api-keys.ts

@@ -56,6 +56,12 @@ export interface APIKeyCreateResponse {
    * The unredacted API key value.
    */
   value: string;
+
+  /**
+   * The Unix timestamp (in seconds) when the API key expires, or null if it does not
+   * expire.
+   */
+  expires_at?: number | null;
 }
 
 export interface APIKeyCreateParams {
@@ -64,6 +70,11 @@ export interface APIKeyCreateParams {
    */
   project_id: string;
 
+  /**
+   * Body param: Number of seconds until the API key expires.
+   */
+  expires_in_seconds?: number | null;
+
   /**
    * Body param: API key name.
    */

package/src/resources/admin/organization/projects/service-accounts/service-accounts.ts

@@ -205,6 +205,12 @@ export namespace ServiceAccountCreateResponse {
     object: 'organization.project.service_account.api_key';
 
     value: string;
+
+    /**
+     * The Unix timestamp (in seconds) when the API key expires, or null if it does not
+     * expire.
+     */
+    expires_at?: number | null;
   }
 }
 
@@ -226,6 +232,15 @@ export interface ServiceAccountCreateParams {
    * Create the service account without default roles or an API key.
    */
   create_service_account_only?: boolean | null;
+
+  /**
+   * Number of seconds until the initial API key expires. If omitted or null, the key
+   * does not expire unless the effective organization or project policy requires an
+   * expiration. When a policy sets a maximum lifetime, this value must be provided
+   * and must not exceed that limit. A non-null value cannot be used when
+   * `create_service_account_only` is true.
+   */
+  expires_in_seconds?: number | null;
 }
 
 export interface ServiceAccountRetrieveParams {

package/src/resources/audio/speech.ts

@@ -46,7 +46,8 @@ export interface SpeechCreateParams {
   input: string;
 
   /**
-   * One of the available [TTS models](https://platform.openai.com/docs/models#tts):
+   * One of the available
+   * [TTS models](https://developers.openai.com/api/docs/guides/text-to-speech):
    * `tts-1`, `tts-1-hd`, `gpt-4o-mini-tts`, or `gpt-4o-mini-tts-2025-12-15`.
    */
   model: (string & {}) | SpeechModel;
@@ -57,7 +58,7 @@ export interface SpeechCreateParams {
    * `shimmer`, `verse`, `marin`, and `cedar`. You may also provide a custom voice
    * object with an `id`, for example `{ "id": "voice_1234" }`. Previews of the
    * voices are available in the
-   * [Text to speech guide](https://platform.openai.com/docs/guides/text-to-speech#voice-options).
+   * [Text to speech guide](https://developers.openai.com/api/docs/guides/text-to-speech#voice-options).
    */
   voice:
     | string

package/src/resources/audio/transcriptions.ts

@@ -381,7 +381,7 @@ export interface TranscriptionSegment {
 /**
  * Emitted when a diarized transcription returns a completed segment with speaker
  * information. Only emitted when you
- * [create a transcription](https://platform.openai.com/docs/api-reference/audio/create-transcription)
+ * [create a transcription](https://developers.openai.com/api/reference/resources/audio/subresources/transcriptions/methods/create)
  * with `stream` set to `true` and `response_format` set to `diarized_json`.
  */
 export type TranscriptionStreamEvent =
@@ -392,7 +392,7 @@ export type TranscriptionStreamEvent =
 /**
  * Emitted when there is an additional text delta. This is also the first event
  * emitted when the transcription starts. Only emitted when you
- * [create a transcription](https://platform.openai.com/docs/api-reference/audio/create-transcription)
+ * [create a transcription](https://developers.openai.com/api/reference/resources/audio/subresources/transcriptions/methods/create)
  * with the `Stream` parameter set to `true`.
  */
 export interface TranscriptionTextDeltaEvent {
@@ -408,7 +408,7 @@ export interface TranscriptionTextDeltaEvent {
 
   /**
    * The log probabilities of the delta. Only included if you
-   * [create a transcription](https://platform.openai.com/docs/api-reference/audio/create-transcription)
+   * [create a transcription](https://developers.openai.com/api/reference/resources/audio/subresources/transcriptions/methods/create)
    * with the `include[]` parameter set to `logprobs`.
    */
   logprobs?: Array<TranscriptionTextDeltaEvent.Logprob>;
@@ -442,7 +442,7 @@ export namespace TranscriptionTextDeltaEvent {
 /**
  * Emitted when the transcription is complete. Contains the complete transcription
  * text. Only emitted when you
- * [create a transcription](https://platform.openai.com/docs/api-reference/audio/create-transcription)
+ * [create a transcription](https://developers.openai.com/api/reference/resources/audio/subresources/transcriptions/methods/create)
  * with the `Stream` parameter set to `true`.
  */
 export interface TranscriptionTextDoneEvent {
@@ -465,7 +465,7 @@ export interface TranscriptionTextDoneEvent {
   /**
    * The log probabilities of the individual tokens in the transcription. Only
    * included if you
-   * [create a transcription](https://platform.openai.com/docs/api-reference/audio/create-transcription)
+   * [create a transcription](https://developers.openai.com/api/reference/resources/audio/subresources/transcriptions/methods/create)
    * with the `include[]` parameter set to `logprobs`.
    */
   logprobs?: Array<TranscriptionTextDoneEvent.Logprob>;
@@ -545,7 +545,7 @@ export namespace TranscriptionTextDoneEvent {
 /**
  * Emitted when a diarized transcription returns a completed segment with speaker
  * information. Only emitted when you
- * [create a transcription](https://platform.openai.com/docs/api-reference/audio/create-transcription)
+ * [create a transcription](https://developers.openai.com/api/reference/resources/audio/subresources/transcriptions/methods/create)
  * with `stream` set to `true` and `response_format` set to `diarized_json`.
  */
 export interface TranscriptionTextSegmentEvent {
@@ -738,7 +738,7 @@ export interface TranscriptionCreateParamsBase<
   /**
    * 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)
+   * [prompt](https://developers.openai.com/api/docs/guides/speech-to-text#prompting)
    * should match the audio language. This field is not supported when using
    * `gpt-4o-transcribe-diarize`.
    */
@@ -758,7 +758,7 @@ export interface TranscriptionCreateParamsBase<
    * generated using
    * [server-sent events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events#Event_stream_format).
    * See the
-   * [Streaming section of the Speech-to-Text guide](https://platform.openai.com/docs/guides/speech-to-text?lang=curl#streaming-transcriptions)
+   * [Streaming section of the Speech-to-Text guide](https://developers.openai.com/api/docs/guides/speech-to-text?lang=curl#streaming)
    * for more information.
    *
    * Note: Streaming is not supported for the `whisper-1` model and will be ignored.
@@ -824,7 +824,7 @@ export interface TranscriptionCreateParamsNonStreaming<
    * generated using
    * [server-sent events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events#Event_stream_format).
    * See the
-   * [Streaming section of the Speech-to-Text guide](https://platform.openai.com/docs/guides/speech-to-text?lang=curl#streaming-transcriptions)
+   * [Streaming section of the Speech-to-Text guide](https://developers.openai.com/api/docs/guides/speech-to-text?lang=curl#streaming)
    * for more information.
    *
    * Note: Streaming is not supported for the `whisper-1` model and will be ignored.
@@ -838,7 +838,7 @@ export interface TranscriptionCreateParamsStreaming extends TranscriptionCreateP
    * generated using
    * [server-sent events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events#Event_stream_format).
    * See the
-   * [Streaming section of the Speech-to-Text guide](https://platform.openai.com/docs/guides/speech-to-text?lang=curl#streaming-transcriptions)
+   * [Streaming section of the Speech-to-Text guide](https://developers.openai.com/api/docs/guides/speech-to-text?lang=curl#streaming)
    * for more information.
    *
    * Note: Streaming is not supported for the `whisper-1` model and will be ignored.

package/src/resources/audio/translations.ts

@@ -95,7 +95,7 @@ export interface TranslationCreateParams<
   /**
    * 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)
+   * [prompt](https://developers.openai.com/api/docs/guides/speech-to-text#prompting)
    * should be in English.
    */
   prompt?: string;

package/src/resources/batches.ts

@@ -157,8 +157,8 @@ export interface Batch {
    * Model ID used to process the batch, like `gpt-6-astra`. OpenAI offers a wide
    * range of models with different capabilities, performance characteristics, and
    * price points. Refer to the
-   * [model guide](https://platform.openai.com/docs/models) to browse and compare
-   * available models.
+   * [model guide](https://developers.openai.com/api/docs/models) to browse and
+   * compare available models.
    */
   model?: string;
 
@@ -272,7 +272,7 @@ export namespace BatchUsage {
   export interface InputTokensDetails {
     /**
      * The number of tokens that were retrieved from the cache.
-     * [More on prompt caching](https://platform.openai.com/docs/guides/prompt-caching).
+     * [More on prompt caching](https://developers.openai.com/api/docs/guides/prompt-caching).
      */
     cached_tokens: number;
   }
@@ -316,11 +316,12 @@ export interface BatchCreateParams {
   /**
    * The ID of an uploaded file that contains requests for the new batch.
    *
-   * See [upload file](https://platform.openai.com/docs/api-reference/files/create)
+   * See
+   * [upload file](https://developers.openai.com/api/reference/resources/files/methods/create)
    * for how to upload a file.
    *
    * Your input file must be formatted as a
-   * [JSONL file](https://platform.openai.com/docs/api-reference/batch/request-input),
+   * [JSONL file](https://developers.openai.com/api/docs/guides/batch#1-prepare-your-batch-file),
    * and must be uploaded with the purpose `batch`. The file can contain up to 50,000
    * requests, and can be up to 200 MB in size.
    */