💾Files

Files are used to upload documents that can be used with features like Assistants, Fine-tuning, and Batch API.

Upload file

Upload a file that can be used across various endpoints. Individual files can be up to 512 MB, and the size of all files uploaded by one organization can be up to 100 GB.

Assistants API

• Supports files up to 2 million tokens and of specific file types.

• See the Assistants Tools guide for details.

Fine-tuning API

• Only supports .jsonl file.

• The input also has certain required formats for fine-tuning chat or completions models.

Batch API

• Only supports .jsonl file.

• Up to 100 MB in size.

• The input also has a specific required format.

C#

var file = new FormFile("path/to/mydata.jsonl");

var request = new FileUploadRequest.Builder()
    .SetFile(file)
    .SetPurpose(UploadPurpose.FineTune)
    .Build();

var result = await OpenAI.DefaultInstance.Files.Upload(request);

Debug.Log(result.Id);

Python (Official SDK)

from openai import OpenAI
client = OpenAI()

client.files.create(
  file=open("mydata.jsonl", "rb"),
  purpose="fine-tune"
)

Please contact OpenAI if you need to increase these storage limits.

---

List files

Returns a list of files that belong to the user's organization.

C#

var fileList = await OpenAI.DefaultInstance.Files.List();

foreach (var fileData in fileList)
{
    Debug.Log(fileData.Id);
    Debug.Log(fileData.CreatedAt);
    Debug.Log(fileData.Purpose);
}

Python (Official SDK)

from openai import OpenAI
client = OpenAI()

client.files.list()

---

Retrieve file

Returns information about a specific file.

C#

var fileData = await OpenAI.DefaultInstance.Files.Retrieve("file-abc123");

Debug.Log(fileData.Id);

Python (Official SDK)

from openai import OpenAI
client = OpenAI()

client.files.retrieve("file-abc123")

---

Delete file

Delete a file.

C#

bool deleted = await OpenAI.DefaultInstance.Files.Delete("file-abc123");

if (deleted)
{
    Debug.Log("File deleted successfully");
}

Python (Official SDK)

from openai import OpenAI
client = OpenAI()

client.files.delete("file-abc123")

---

Retrieve file content

Returns the contents of the specified file.

C#

var content = await OpenAI.DefaultInstance.Files.RetrieveFileContent("file-abc123");

Debug.Log(content);

Python (Official SDK)

from openai import OpenAI
client = OpenAI()

content = client.files.content("file-abc123")