File Management
Upload and manage files for use with AI models.
Upload File
POST /v1/filesUpload a file for later use with batch operations, fine-tuning, or file search.
Request
file = client.files.create(
file=open("training_data.jsonl", "rb"),
purpose="batch"
)
print(f"File ID: {file.id}")Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
file | file | Yes | The file to upload |
purpose | string | Yes | Purpose: batch, fine-tune, assistants |
List Files
GET /v1/filesfiles = client.files.list()
for f in files.data:
print(f"{f.id} - {f.filename} ({f.bytes} bytes)")Get File Info
GET /v1/files/{file_id}Get File Content
GET /v1/files/{file_id}/contentDelete File
DELETE /v1/files/{file_id}client.files.delete("file-abc123")Supported Formats
| Purpose | Formats |
|---|---|
batch | .jsonl |
fine-tune | .jsonl |
assistants | .pdf, .txt, .md, .docx, images |
File Size Limits
| Plan | Max File Size | Max Total Storage |
|---|---|---|
| Free | 10 MB | 100 MB |
| Basic | 100 MB | 1 GB |
| Pro | 512 MB | 10 GB |
| Enterprise | Custom | Custom |
How is this guide?