AI_botter/node_modules/openai/resources/files.d.ts
2024-04-30 17:46:10 -08:00

135 lines
No EOL
4.7 KiB
TypeScript

import * as Core from 'openai/core';
import { APIResource } from 'openai/resource';
import { type Response } from 'openai/_shims/index';
import * as FilesAPI from 'openai/resources/files';
import { type Uploadable } from 'openai/core';
import { Page } from 'openai/pagination';
export declare class Files extends APIResource {
/**
* Upload a file that can be used across various endpoints. The size of all the
* files uploaded by one organization can be up to 100 GB.
*
* The size of individual files can be a maximum of 512 MB or 2 million tokens for
* Assistants. See the
* [Assistants Tools guide](https://platform.openai.com/docs/assistants/tools) to
* learn more about the types of files supported. The Fine-tuning API only supports
* `.jsonl` files.
*
* Please [contact us](https://help.openai.com/) if you need to increase these
* storage limits.
*/
create(body: FileCreateParams, options?: Core.RequestOptions): Core.APIPromise<FileObject>;
/**
* Returns information about a specific file.
*/
retrieve(fileId: string, options?: Core.RequestOptions): Core.APIPromise<FileObject>;
/**
* Returns a list of files that belong to the user's organization.
*/
list(query?: FileListParams, options?: Core.RequestOptions): Core.PagePromise<FileObjectsPage, FileObject>;
list(options?: Core.RequestOptions): Core.PagePromise<FileObjectsPage, FileObject>;
/**
* Delete a file.
*/
del(fileId: string, options?: Core.RequestOptions): Core.APIPromise<FileDeleted>;
/**
* Returns the contents of the specified file.
*/
content(fileId: string, options?: Core.RequestOptions): Core.APIPromise<Response>;
/**
* Returns the contents of the specified file.
*
* @deprecated The `.content()` method should be used instead
*/
retrieveContent(fileId: string, options?: Core.RequestOptions): Core.APIPromise<string>;
/**
* Waits for the given file to be processed, default timeout is 30 mins.
*/
waitForProcessing(id: string, { pollInterval, maxWait }?: {
pollInterval?: number;
maxWait?: number;
}): Promise<FileObject>;
}
/**
* Note: no pagination actually occurs yet, this is for forwards-compatibility.
*/
export declare class FileObjectsPage extends Page<FileObject> {
}
export type FileContent = string;
export interface FileDeleted {
id: string;
deleted: boolean;
object: 'file';
}
/**
* The `File` object represents a document that has been uploaded to OpenAI.
*/
export interface FileObject {
/**
* The file identifier, which can be referenced in the API endpoints.
*/
id: string;
/**
* The size of the file, in bytes.
*/
bytes: number;
/**
* The Unix timestamp (in seconds) for when the file was created.
*/
created_at: number;
/**
* The name of the file.
*/
filename: string;
/**
* The object type, which is always `file`.
*/
object: 'file';
/**
* The intended purpose of the file. Supported values are `fine-tune`,
* `fine-tune-results`, `assistants`, and `assistants_output`.
*/
purpose: 'fine-tune' | 'fine-tune-results' | 'assistants' | 'assistants_output';
/**
* Deprecated. The current status of the file, which can be either `uploaded`,
* `processed`, or `error`.
*/
status: 'uploaded' | 'processed' | 'error';
/**
* Deprecated. For details on why a fine-tuning training file failed validation,
* see the `error` field on `fine_tuning.job`.
*/
status_details?: string;
}
export interface FileCreateParams {
/**
* The File object (not file name) to be uploaded.
*/
file: Uploadable;
/**
* The intended purpose of the uploaded file.
*
* Use "fine-tune" for
* [Fine-tuning](https://platform.openai.com/docs/api-reference/fine-tuning) and
* "assistants" for
* [Assistants](https://platform.openai.com/docs/api-reference/assistants) and
* [Messages](https://platform.openai.com/docs/api-reference/messages). This allows
* us to validate the format of the uploaded file is correct for fine-tuning.
*/
purpose: 'fine-tune' | 'assistants';
}
export interface FileListParams {
/**
* Only return files with the given purpose.
*/
purpose?: string;
}
export declare namespace Files {
export import FileContent = FilesAPI.FileContent;
export import FileDeleted = FilesAPI.FileDeleted;
export import FileObject = FilesAPI.FileObject;
export import FileObjectsPage = FilesAPI.FileObjectsPage;
export import FileCreateParams = FilesAPI.FileCreateParams;
export import FileListParams = FilesAPI.FileListParams;
}
//# sourceMappingURL=files.d.ts.map