88 lines
3.2 KiB
JavaScript
88 lines
3.2 KiB
JavaScript
|
// File generated from our OpenAPI spec by Stainless.
|
||
|
|
import { APIResource } from 'openai/resource';
|
||
|
|
import { isRequestOptions } from 'openai/core';
|
||
|
|
import { sleep } from 'openai/core';
|
||
|
|
import { APIConnectionTimeoutError } from 'openai/error';
|
||
|
|
import * as FilesAPI from 'openai/resources/files';
|
||
|
|
import { multipartFormRequestOptions } from 'openai/core';
|
||
|
|
import { Page } from 'openai/pagination';
|
||
|
|
export 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, options) {
|
||
|
|
return this._client.post('/files', multipartFormRequestOptions({ body, ...options }));
|
||
|
|
}
|
||
|
|
/**
|
||
|
|
* Returns information about a specific file.
|
||
|
|
*/
|
||
|
|
retrieve(fileId, options) {
|
||
|
|
return this._client.get(`/files/${fileId}`, options);
|
||
|
|
}
|
||
|
|
list(query = {}, options) {
|
||
|
|
if (isRequestOptions(query)) {
|
||
|
|
return this.list({}, query);
|
||
|
|
}
|
||
|
|
return this._client.getAPIList('/files', FileObjectsPage, { query, ...options });
|
||
|
|
}
|
||
|
|
/**
|
||
|
|
* Delete a file.
|
||
|
|
*/
|
||
|
|
del(fileId, options) {
|
||
|
|
return this._client.delete(`/files/${fileId}`, options);
|
||
|
|
}
|
||
|
|
/**
|
||
|
|
* Returns the contents of the specified file.
|
||
|
|
*/
|
||
|
|
content(fileId, options) {
|
||
|
|
return this._client.get(`/files/${fileId}/content`, { ...options, __binaryResponse: true });
|
||
|
|
}
|
||
|
|
/**
|
||
|
|
* Returns the contents of the specified file.
|
||
|
|
*
|
||
|
|
* @deprecated The `.content()` method should be used instead
|
||
|
|
*/
|
||
|
|
retrieveContent(fileId, options) {
|
||
|
|
return this._client.get(`/files/${fileId}/content`, {
|
||
|
|
...options,
|
||
|
|
headers: { Accept: 'application/json', ...options?.headers },
|
||
|
|
});
|
||
|
|
}
|
||
|
|
/**
|
||
|
|
* Waits for the given file to be processed, default timeout is 30 mins.
|
||
|
|
*/
|
||
|
|
async waitForProcessing(id, { pollInterval = 5000, maxWait = 30 * 60 * 1000 } = {}) {
|
||
|
|
const TERMINAL_STATES = new Set(['processed', 'error', 'deleted']);
|
||
|
|
const start = Date.now();
|
||
|
|
let file = await this.retrieve(id);
|
||
|
|
while (!file.status || !TERMINAL_STATES.has(file.status)) {
|
||
|
|
await sleep(pollInterval);
|
||
|
|
file = await this.retrieve(id);
|
||
|
|
if (Date.now() - start > maxWait) {
|
||
|
|
throw new APIConnectionTimeoutError({
|
||
|
|
message: `Giving up on waiting for file ${id} to finish processing after ${maxWait} milliseconds.`,
|
||
|
|
});
|
||
|
|
}
|
||
|
|
}
|
||
|
|
return file;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
/**
|
||
|
|
* Note: no pagination actually occurs yet, this is for forwards-compatibility.
|
||
|
|
*/
|
||
|
|
export class FileObjectsPage extends Page {
|
||
|
|
}
|
||
|
|
(function (Files) {
|
||
|
|
Files.FileObjectsPage = FilesAPI.FileObjectsPage;
|
||
|
|
})(Files || (Files = {}));
|
||
|
|
//# sourceMappingURL=files.mjs.map
|