openai 4.70.3 → 4.71.0

package/src/resources/beta/assistants.ts

@@ -121,8 +121,8 @@ export interface Assistant {
    * ID of the model to use. You can use the
    * [List models](https://platform.openai.com/docs/api-reference/models/list) API to
    * see all of your available models, or see our
-   * [Model overview](https://platform.openai.com/docs/models/overview) for
-   * descriptions of them.
+   * [Model overview](https://platform.openai.com/docs/models) for descriptions of
+   * them.
    */
   model: string;
 
@@ -145,8 +145,8 @@ export interface Assistant {
 
   /**
    * Specifies the format that the model must output. Compatible with
-   * [GPT-4o](https://platform.openai.com/docs/models/gpt-4o),
-   * [GPT-4 Turbo](https://platform.openai.com/docs/models/gpt-4-turbo-and-gpt-4),
+   * [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),
+   * [GPT-4 Turbo](https://platform.openai.com/docs/models#gpt-4-turbo-and-gpt-4),
    * and all GPT-3.5 Turbo models since `gpt-3.5-turbo-1106`.
    *
    * Setting to `{ "type": "json_schema", "json_schema": {...} }` enables Structured
@@ -620,7 +620,7 @@ export namespace AssistantStreamEvent {
 
   /**
    * Occurs when an
-   * [error](https://platform.openai.com/docs/guides/error-codes/api-errors) occurs.
+   * [error](https://platform.openai.com/docs/guides/error-codes#api-errors) occurs.
    * This can happen due to an internal server error or a timeout.
    */
   export interface ErrorEvent {
@@ -663,7 +663,7 @@ export namespace FileSearchTool {
      *
      * Note that the file search tool may output fewer than `max_num_results` results.
      * See the
-     * [file search tool documentation](https://platform.openai.com/docs/assistants/tools/file-search/customizing-file-search-settings)
+     * [file search tool documentation](https://platform.openai.com/docs/assistants/tools/file-search#customizing-file-search-settings)
      * for more information.
      */
     max_num_results?: number;
@@ -673,7 +673,7 @@ export namespace FileSearchTool {
      * will use the `auto` ranker and a score_threshold of 0.
      *
      * See the
-     * [file search tool documentation](https://platform.openai.com/docs/assistants/tools/file-search/customizing-file-search-settings)
+     * [file search tool documentation](https://platform.openai.com/docs/assistants/tools/file-search#customizing-file-search-settings)
      * for more information.
      */
     ranking_options?: FileSearch.RankingOptions;
@@ -685,7 +685,7 @@ export namespace FileSearchTool {
      * will use the `auto` ranker and a score_threshold of 0.
      *
      * See the
-     * [file search tool documentation](https://platform.openai.com/docs/assistants/tools/file-search/customizing-file-search-settings)
+     * [file search tool documentation](https://platform.openai.com/docs/assistants/tools/file-search#customizing-file-search-settings)
      * for more information.
      */
     export interface RankingOptions {
@@ -1100,8 +1100,8 @@ export interface AssistantCreateParams {
    * ID of the model to use. You can use the
    * [List models](https://platform.openai.com/docs/api-reference/models/list) API to
    * see all of your available models, or see our
-   * [Model overview](https://platform.openai.com/docs/models/overview) for
-   * descriptions of them.
+   * [Model overview](https://platform.openai.com/docs/models) for descriptions of
+   * them.
    */
   model: (string & {}) | ChatAPI.ChatModel;
 
@@ -1131,8 +1131,8 @@ export interface AssistantCreateParams {
 
   /**
    * Specifies the format that the model must output. Compatible with
-   * [GPT-4o](https://platform.openai.com/docs/models/gpt-4o),
-   * [GPT-4 Turbo](https://platform.openai.com/docs/models/gpt-4-turbo-and-gpt-4),
+   * [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),
+   * [GPT-4 Turbo](https://platform.openai.com/docs/models#gpt-4-turbo-and-gpt-4),
    * and all GPT-3.5 Turbo models since `gpt-3.5-turbo-1106`.
    *
    * Setting to `{ "type": "json_schema", "json_schema": {...} }` enables Structured
@@ -1277,8 +1277,8 @@ export interface AssistantUpdateParams {
    * ID of the model to use. You can use the
    * [List models](https://platform.openai.com/docs/api-reference/models/list) API to
    * see all of your available models, or see our
-   * [Model overview](https://platform.openai.com/docs/models/overview) for
-   * descriptions of them.
+   * [Model overview](https://platform.openai.com/docs/models) for descriptions of
+   * them.
    */
   model?: string;
 
@@ -1289,8 +1289,8 @@ export interface AssistantUpdateParams {
 
   /**
    * Specifies the format that the model must output. Compatible with
-   * [GPT-4o](https://platform.openai.com/docs/models/gpt-4o),
-   * [GPT-4 Turbo](https://platform.openai.com/docs/models/gpt-4-turbo-and-gpt-4),
+   * [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),
+   * [GPT-4 Turbo](https://platform.openai.com/docs/models#gpt-4-turbo-and-gpt-4),
    * and all GPT-3.5 Turbo models since `gpt-3.5-turbo-1106`.
    *
    * Setting to `{ "type": "json_schema", "json_schema": {...} }` enables Structured
@@ -1383,8 +1383,8 @@ export interface AssistantListParams extends CursorPageParams {
   /**
    * A cursor for use in pagination. `before` is an object ID that defines your place
    * in the list. For instance, if you make a list request and receive 100 objects,
-   * ending with obj_foo, your subsequent call can include before=obj_foo in order to
-   * fetch the previous page of the list.
+   * starting with obj_foo, your subsequent call can include before=obj_foo in order
+   * to fetch the previous page of the list.
    */
   before?: string;
 

package/src/resources/beta/threads/messages.ts

@@ -704,8 +704,8 @@ export interface MessageListParams extends CursorPageParams {
   /**
    * A cursor for use in pagination. `before` is an object ID that defines your place
    * in the list. For instance, if you make a list request and receive 100 objects,
-   * ending with obj_foo, your subsequent call can include before=obj_foo in order to
-   * fetch the previous page of the list.
+   * starting with obj_foo, your subsequent call can include before=obj_foo in order
+   * to fetch the previous page of the list.
    */
   before?: string;
 

package/src/resources/beta/threads/runs/runs.ts

@@ -435,7 +435,7 @@ export interface Run {
 
   /**
    * Whether to enable
-   * [parallel function calling](https://platform.openai.com/docs/guides/function-calling/parallel-function-calling)
+   * [parallel function calling](https://platform.openai.com/docs/guides/function-calling#configuring-parallel-function-calling)
    * during tool use.
    */
   parallel_tool_calls: boolean;
@@ -448,8 +448,8 @@ export interface Run {
 
   /**
    * Specifies the format that the model must output. Compatible with
-   * [GPT-4o](https://platform.openai.com/docs/models/gpt-4o),
-   * [GPT-4 Turbo](https://platform.openai.com/docs/models/gpt-4-turbo-and-gpt-4),
+   * [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),
+   * [GPT-4 Turbo](https://platform.openai.com/docs/models#gpt-4-turbo-and-gpt-4),
    * and all GPT-3.5 Turbo models since `gpt-3.5-turbo-1106`.
    *
    * Setting to `{ "type": "json_schema", "json_schema": {...} }` enables Structured
@@ -660,7 +660,7 @@ export interface RunCreateParamsBase {
    * search result content.
    *
    * See the
-   * [file search tool documentation](https://platform.openai.com/docs/assistants/tools/file-search/customizing-file-search-settings)
+   * [file search tool documentation](https://platform.openai.com/docs/assistants/tools/file-search#customizing-file-search-settings)
    * for more information.
    */
   include?: Array<StepsAPI.RunStepInclude>;
@@ -721,15 +721,15 @@ export interface RunCreateParamsBase {
 
   /**
    * Body param: Whether to enable
-   * [parallel function calling](https://platform.openai.com/docs/guides/function-calling/parallel-function-calling)
+   * [parallel function calling](https://platform.openai.com/docs/guides/function-calling#configuring-parallel-function-calling)
    * during tool use.
    */
   parallel_tool_calls?: boolean;
 
   /**
    * Body param: Specifies the format that the model must output. Compatible with
-   * [GPT-4o](https://platform.openai.com/docs/models/gpt-4o),
-   * [GPT-4 Turbo](https://platform.openai.com/docs/models/gpt-4-turbo-and-gpt-4),
+   * [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),
+   * [GPT-4 Turbo](https://platform.openai.com/docs/models#gpt-4-turbo-and-gpt-4),
    * and all GPT-3.5 Turbo models since `gpt-3.5-turbo-1106`.
    *
    * Setting to `{ "type": "json_schema", "json_schema": {...} }` enables Structured
@@ -909,8 +909,8 @@ export interface RunListParams extends CursorPageParams {
   /**
    * A cursor for use in pagination. `before` is an object ID that defines your place
    * in the list. For instance, if you make a list request and receive 100 objects,
-   * ending with obj_foo, your subsequent call can include before=obj_foo in order to
-   * fetch the previous page of the list.
+   * starting with obj_foo, your subsequent call can include before=obj_foo in order
+   * to fetch the previous page of the list.
    */
   before?: string;
 

package/src/resources/beta/threads/runs/steps.ts

@@ -705,7 +705,7 @@ export interface StepRetrieveParams {
    * to fetch the file search result content.
    *
    * See the
-   * [file search tool documentation](https://platform.openai.com/docs/assistants/tools/file-search/customizing-file-search-settings)
+   * [file search tool documentation](https://platform.openai.com/docs/assistants/tools/file-search#customizing-file-search-settings)
    * for more information.
    */
   include?: Array<RunStepInclude>;
@@ -715,8 +715,8 @@ export interface StepListParams extends CursorPageParams {
   /**
    * A cursor for use in pagination. `before` is an object ID that defines your place
    * in the list. For instance, if you make a list request and receive 100 objects,
-   * ending with obj_foo, your subsequent call can include before=obj_foo in order to
-   * fetch the previous page of the list.
+   * starting with obj_foo, your subsequent call can include before=obj_foo in order
+   * to fetch the previous page of the list.
    */
   before?: string;
 
@@ -726,7 +726,7 @@ export interface StepListParams extends CursorPageParams {
    * to fetch the file search result content.
    *
    * See the
-   * [file search tool documentation](https://platform.openai.com/docs/assistants/tools/file-search/customizing-file-search-settings)
+   * [file search tool documentation](https://platform.openai.com/docs/assistants/tools/file-search#customizing-file-search-settings)
    * for more information.
    */
   include?: Array<RunStepInclude>;

package/src/resources/beta/threads/threads.ts

@@ -176,8 +176,8 @@ export class Threads extends APIResource {
 
 /**
  * Specifies the format that the model must output. Compatible with
- * [GPT-4o](https://platform.openai.com/docs/models/gpt-4o),
- * [GPT-4 Turbo](https://platform.openai.com/docs/models/gpt-4-turbo-and-gpt-4),
+ * [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),
+ * [GPT-4 Turbo](https://platform.openai.com/docs/models#gpt-4-turbo-and-gpt-4),
  * and all GPT-3.5 Turbo models since `gpt-3.5-turbo-1106`.
  *
  * Setting to `{ "type": "json_schema", "json_schema": {...} }` enables Structured
@@ -565,15 +565,15 @@ export interface ThreadCreateAndRunParamsBase {
 
   /**
    * Whether to enable
-   * [parallel function calling](https://platform.openai.com/docs/guides/function-calling/parallel-function-calling)
+   * [parallel function calling](https://platform.openai.com/docs/guides/function-calling#configuring-parallel-function-calling)
    * during tool use.
    */
   parallel_tool_calls?: boolean;
 
   /**
    * Specifies the format that the model must output. Compatible with
-   * [GPT-4o](https://platform.openai.com/docs/models/gpt-4o),
-   * [GPT-4 Turbo](https://platform.openai.com/docs/models/gpt-4-turbo-and-gpt-4),
+   * [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),
+   * [GPT-4 Turbo](https://platform.openai.com/docs/models#gpt-4-turbo-and-gpt-4),
    * and all GPT-3.5 Turbo models since `gpt-3.5-turbo-1106`.
    *
    * Setting to `{ "type": "json_schema", "json_schema": {...} }` enables Structured

package/src/resources/beta/vector-stores/file-batches.ts

@@ -276,8 +276,8 @@ export interface FileBatchListFilesParams extends CursorPageParams {
   /**
    * A cursor for use in pagination. `before` is an object ID that defines your place
    * in the list. For instance, if you make a list request and receive 100 objects,
-   * ending with obj_foo, your subsequent call can include before=obj_foo in order to
-   * fetch the previous page of the list.
+   * starting with obj_foo, your subsequent call can include before=obj_foo in order
+   * to fetch the previous page of the list.
    */
   before?: string;
 

package/src/resources/beta/vector-stores/files.ts

@@ -268,8 +268,8 @@ export interface FileListParams extends CursorPageParams {
   /**
    * A cursor for use in pagination. `before` is an object ID that defines your place
    * in the list. For instance, if you make a list request and receive 100 objects,
-   * ending with obj_foo, your subsequent call can include before=obj_foo in order to
-   * fetch the previous page of the list.
+   * starting with obj_foo, your subsequent call can include before=obj_foo in order
+   * to fetch the previous page of the list.
    */
   before?: string;
 

package/src/resources/beta/vector-stores/vector-stores.ts

@@ -372,8 +372,8 @@ export interface VectorStoreListParams extends CursorPageParams {
   /**
    * A cursor for use in pagination. `before` is an object ID that defines your place
    * in the list. For instance, if you make a list request and receive 100 objects,
-   * ending with obj_foo, your subsequent call can include before=obj_foo in order to
-   * fetch the previous page of the list.
+   * starting with obj_foo, your subsequent call can include before=obj_foo in order
+   * to fetch the previous page of the list.
    */
   before?: string;
 

package/src/resources/chat/chat.ts

@@ -23,6 +23,7 @@ import {
   ChatCompletionMessageToolCall,
   ChatCompletionModality,
   ChatCompletionNamedToolChoice,
+  ChatCompletionPredictionContent,
   ChatCompletionRole,
   ChatCompletionStreamOptions,
   ChatCompletionSystemMessageParam,
@@ -101,6 +102,7 @@ export declare namespace Chat {
     type ChatCompletionMessageToolCall as ChatCompletionMessageToolCall,
     type ChatCompletionModality as ChatCompletionModality,
     type ChatCompletionNamedToolChoice as ChatCompletionNamedToolChoice,
+    type ChatCompletionPredictionContent as ChatCompletionPredictionContent,
     type ChatCompletionRole as ChatCompletionRole,
     type ChatCompletionStreamOptions as ChatCompletionStreamOptions,
     type ChatCompletionSystemMessageParam as ChatCompletionSystemMessageParam,

package/src/resources/chat/completions.ts

@@ -469,7 +469,7 @@ export namespace ChatCompletionContentPartImage {
 
     /**
      * Specifies the detail level of the image. Learn more in the
-     * [Vision guide](https://platform.openai.com/docs/guides/vision/low-or-high-fidelity-image-understanding).
+     * [Vision guide](https://platform.openai.com/docs/guides/vision#low-or-high-fidelity-image-understanding).
      */
     detail?: 'auto' | 'low' | 'high';
   }
@@ -687,6 +687,25 @@ export namespace ChatCompletionNamedToolChoice {
   }
 }
 
+/**
+ * Static predicted output content, such as the content of a text file that is
+ * being regenerated.
+ */
+export interface ChatCompletionPredictionContent {
+  /**
+   * The content that should be matched when generating a model response. If
+   * generated tokens would match this content, the entire model response can be
+   * returned much more quickly.
+   */
+  content: string | Array<ChatCompletionContentPartText>;
+
+  /**
+   * The type of the predicted content you want to provide. This type is currently
+   * always `content`.
+   */
+  type: 'content';
+}
+
 /**
  * The role of the author of a message
  */
@@ -855,7 +874,7 @@ export interface ChatCompletionCreateParamsBase {
 
   /**
    * ID of the model to use. See the
-   * [model endpoint compatibility](https://platform.openai.com/docs/models/model-endpoint-compatibility)
+   * [model endpoint compatibility](https://platform.openai.com/docs/models#model-endpoint-compatibility)
    * table for details on which models work with the Chat API.
    */
   model: (string & {}) | ChatAPI.ChatModel;
@@ -872,7 +891,7 @@ export interface ChatCompletionCreateParamsBase {
    * existing frequency in the text so far, decreasing the model's likelihood to
    * repeat the same line verbatim.
    *
-   * [See more information about frequency and presence penalties.](https://platform.openai.com/docs/guides/text-generation/parameter-details)
+   * [See more information about frequency and presence penalties.](https://platform.openai.com/docs/guides/text-generation)
    */
   frequency_penalty?: number | null;
 
@@ -963,25 +982,31 @@ export interface ChatCompletionCreateParamsBase {
 
   /**
    * Whether to enable
-   * [parallel function calling](https://platform.openai.com/docs/guides/function-calling/parallel-function-calling)
+   * [parallel function calling](https://platform.openai.com/docs/guides/function-calling#configuring-parallel-function-calling)
    * during tool use.
    */
   parallel_tool_calls?: boolean;
 
+  /**
+   * Static predicted output content, such as the content of a text file that is
+   * being regenerated.
+   */
+  prediction?: ChatCompletionPredictionContent | null;
+
   /**
    * Number between -2.0 and 2.0. Positive values penalize new tokens based on
    * whether they appear in the text so far, increasing the model's likelihood to
    * talk about new topics.
    *
-   * [See more information about frequency and presence penalties.](https://platform.openai.com/docs/guides/text-generation/parameter-details)
+   * [See more information about frequency and presence penalties.](https://platform.openai.com/docs/guides/text-generation)
    */
   presence_penalty?: number | null;
 
   /**
    * An object specifying the format that the model must output. Compatible with
-   * [GPT-4o](https://platform.openai.com/docs/models/gpt-4o),
-   * [GPT-4o mini](https://platform.openai.com/docs/models/gpt-4o-mini),
-   * [GPT-4 Turbo](https://platform.openai.com/docs/models/gpt-4-and-gpt-4-turbo) and
+   * [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),
+   * [GPT-4o mini](https://platform.openai.com/docs/models#gpt-4o-mini),
+   * [GPT-4 Turbo](https://platform.openai.com/docs/models#gpt-4-turbo-and-gpt-4) and
    * all GPT-3.5 Turbo models newer than `gpt-3.5-turbo-1106`.
    *
    * Setting to `{ "type": "json_schema", "json_schema": {...} }` enables Structured
@@ -1107,7 +1132,7 @@ export interface ChatCompletionCreateParamsBase {
   /**
    * A unique identifier representing your end-user, which can help OpenAI to monitor
    * and detect abuse.
-   * [Learn more](https://platform.openai.com/docs/guides/safety-best-practices/end-user-ids).
+   * [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#end-user-ids).
    */
   user?: string;
 }
@@ -1204,6 +1229,7 @@ export declare namespace Completions {
     type ChatCompletionMessageToolCall as ChatCompletionMessageToolCall,
     type ChatCompletionModality as ChatCompletionModality,
     type ChatCompletionNamedToolChoice as ChatCompletionNamedToolChoice,
+    type ChatCompletionPredictionContent as ChatCompletionPredictionContent,
     type ChatCompletionRole as ChatCompletionRole,
     type ChatCompletionStreamOptions as ChatCompletionStreamOptions,
     type ChatCompletionSystemMessageParam as ChatCompletionSystemMessageParam,

package/src/resources/chat/index.ts

@@ -20,6 +20,7 @@ export {
   type ChatCompletionMessageToolCall,
   type ChatCompletionModality,
   type ChatCompletionNamedToolChoice,
+  type ChatCompletionPredictionContent,
   type ChatCompletionRole,
   type ChatCompletionStreamOptions,
   type ChatCompletionSystemMessageParam,

package/src/resources/completions.ts

@@ -137,6 +137,12 @@ export namespace CompletionUsage {
    * Breakdown of tokens used in a completion.
    */
   export interface CompletionTokensDetails {
+    /**
+     * When using Predicted Outputs, the number of tokens in the prediction that
+     * appeared in the completion.
+     */
+    accepted_prediction_tokens?: number;
+
     /**
      * Audio input tokens generated by the model.
      */
@@ -146,6 +152,14 @@ export namespace CompletionUsage {
      * Tokens generated by the model for reasoning.
      */
     reasoning_tokens?: number;
+
+    /**
+     * When using Predicted Outputs, the number of tokens in the prediction that did
+     * not appear in the completion. However, like reasoning tokens, these tokens are
+     * still counted in the total completion tokens for purposes of billing, output,
+     * and context window limits.
+     */
+    rejected_prediction_tokens?: number;
   }
 
   /**
@@ -171,8 +185,8 @@ export interface CompletionCreateParamsBase {
    * ID of the model to use. You can use the
    * [List models](https://platform.openai.com/docs/api-reference/models/list) API to
    * see all of your available models, or see our
-   * [Model overview](https://platform.openai.com/docs/models/overview) for
-   * descriptions of them.
+   * [Model overview](https://platform.openai.com/docs/models) for descriptions of
+   * them.
    */
   model: (string & {}) | 'gpt-3.5-turbo-instruct' | 'davinci-002' | 'babbage-002';
 
@@ -209,7 +223,7 @@ export interface CompletionCreateParamsBase {
    * existing frequency in the text so far, decreasing the model's likelihood to
    * repeat the same line verbatim.
    *
-   * [See more information about frequency and presence penalties.](https://platform.openai.com/docs/guides/text-generation/parameter-details)
+   * [See more information about frequency and presence penalties.](https://platform.openai.com/docs/guides/text-generation)
    */
   frequency_penalty?: number | null;
 
@@ -264,7 +278,7 @@ export interface CompletionCreateParamsBase {
    * whether they appear in the text so far, increasing the model's likelihood to
    * talk about new topics.
    *
-   * [See more information about frequency and presence penalties.](https://platform.openai.com/docs/guides/text-generation/parameter-details)
+   * [See more information about frequency and presence penalties.](https://platform.openai.com/docs/guides/text-generation)
    */
   presence_penalty?: number | null;
 
@@ -327,7 +341,7 @@ export interface CompletionCreateParamsBase {
   /**
    * A unique identifier representing your end-user, which can help OpenAI to monitor
    * and detect abuse.
-   * [Learn more](https://platform.openai.com/docs/guides/safety-best-practices/end-user-ids).
+   * [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#end-user-ids).
    */
   user?: string;
 }

package/src/resources/embeddings.ts

@@ -94,8 +94,8 @@ export interface EmbeddingCreateParams {
    * ID of the model to use. You can use the
    * [List models](https://platform.openai.com/docs/api-reference/models/list) API to
    * see all of your available models, or see our
-   * [Model overview](https://platform.openai.com/docs/models/overview) for
-   * descriptions of them.
+   * [Model overview](https://platform.openai.com/docs/models) for descriptions of
+   * them.
    */
   model: (string & {}) | EmbeddingModel;
 
@@ -114,7 +114,7 @@ export interface EmbeddingCreateParams {
   /**
    * A unique identifier representing your end-user, which can help OpenAI to monitor
    * and detect abuse.
-   * [Learn more](https://platform.openai.com/docs/guides/safety-best-practices/end-user-ids).
+   * [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#end-user-ids).
    */
   user?: string;
 }

package/src/resources/files.ts

@@ -5,7 +5,7 @@ import { isRequestOptions } from '../core';
 import { sleep } from '../core';
 import { APIConnectionTimeoutError } from '../error';
 import * as Core from '../core';
-import { Page } from '../pagination';
+import { CursorPage, type CursorPageParams } from '../pagination';
 import { type Response } from '../_shims/index';
 
 export class Files extends APIResource {
@@ -44,7 +44,7 @@ export class Files extends APIResource {
   }
 
   /**
-   * Returns a list of files that belong to the user's organization.
+   * Returns a list of files.
    */
   list(query?: FileListParams, options?: Core.RequestOptions): Core.PagePromise<FileObjectsPage, FileObject>;
   list(options?: Core.RequestOptions): Core.PagePromise<FileObjectsPage, FileObject>;
@@ -111,10 +111,7 @@ export class Files extends APIResource {
   }
 }
 
-/**
- * Note: no pagination actually occurs yet, this is for forwards-compatibility.
- */
-export class FileObjectsPage extends Page<FileObject> {}
+export class FileObjectsPage extends CursorPage<FileObject> {}
 
 export type FileContent = string;
 
@@ -213,7 +210,13 @@ export interface FileCreateParams {
   purpose: FilePurpose;
 }
 
-export interface FileListParams {
+export interface FileListParams extends CursorPageParams {
+  /**
+   * Sort order by the `created_at` timestamp of the objects. `asc` for ascending
+   * order and `desc` for descending order.
+   */
+  order?: 'asc' | 'desc';
+
   /**
    * Only return files with the given purpose.
    */

package/src/resources/fine-tuning/jobs/jobs.ts

@@ -304,7 +304,7 @@ export interface FineTuningJobWandbIntegrationObject {
 export interface JobCreateParams {
   /**
    * The name of the model to fine-tune. You can select one of the
-   * [supported models](https://platform.openai.com/docs/guides/fine-tuning/which-models-can-be-fine-tuned).
+   * [supported models](https://platform.openai.com/docs/guides/fine-tuning#which-models-can-be-fine-tuned).
    */
   model: (string & {}) | 'babbage-002' | 'davinci-002' | 'gpt-3.5-turbo' | 'gpt-4o-mini';
 

package/src/resources/images.ts

@@ -94,7 +94,7 @@ export interface ImageCreateVariationParams {
   /**
    * A unique identifier representing your end-user, which can help OpenAI to monitor
    * and detect abuse.
-   * [Learn more](https://platform.openai.com/docs/guides/safety-best-practices/end-user-ids).
+   * [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#end-user-ids).
    */
   user?: string;
 }
@@ -146,7 +146,7 @@ export interface ImageEditParams {
   /**
    * A unique identifier representing your end-user, which can help OpenAI to monitor
    * and detect abuse.
-   * [Learn more](https://platform.openai.com/docs/guides/safety-best-practices/end-user-ids).
+   * [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#end-user-ids).
    */
   user?: string;
 }
@@ -201,7 +201,7 @@ export interface ImageGenerateParams {
   /**
    * A unique identifier representing your end-user, which can help OpenAI to monitor
    * and detect abuse.
-   * [Learn more](https://platform.openai.com/docs/guides/safety-best-practices/end-user-ids).
+   * [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#end-user-ids).
    */
   user?: string;
 }

package/src/resources/moderations.ts

@@ -351,7 +351,7 @@ export interface ModerationCreateParams {
    * The content moderation model you would like to use. Learn more in
    * [the moderation guide](https://platform.openai.com/docs/guides/moderation), and
    * learn about available models
-   * [here](https://platform.openai.com/docs/models/moderation).
+   * [here](https://platform.openai.com/docs/models#moderation).
    */
   model?: (string & {}) | ModerationModel;
 }

package/src/resources/uploads/uploads.ts

@@ -25,7 +25,7 @@ export class Uploads extends APIResource {
    * For certain `purpose`s, the correct `mime_type` must be specified. Please refer
    * to documentation for the supported MIME types for your use case:
    *
-   * - [Assistants](https://platform.openai.com/docs/assistants/tools/file-search/supported-files)
+   * - [Assistants](https://platform.openai.com/docs/assistants/tools/file-search#supported-files)
    *
    * For guidance on the proper filename extensions for each purpose, please follow
    * the documentation on

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '4.70.3'; // x-release-please-version
+export const VERSION = '4.71.0'; // x-release-please-version

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "4.70.3";
+export declare const VERSION = "4.71.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '4.70.3'; // x-release-please-version
+exports.VERSION = '4.71.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '4.70.3'; // x-release-please-version
+export const VERSION = '4.71.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map