Files

GET    https://api.bve.me/v1/files
POST   https://api.bve.me/v1/files
GET    https://api.bve.me/v1/files/:file_id
DELETE https://api.bve.me/v1/files/:file_id
GET    https://api.bve.me/v1/files/:file_id/content

Requires Authorization: Bearer sk-bve-YOUR_KEY.

The Files API lets you upload and reference files for use with the Assistants API, fine-tuning, and other endpoints.

Shared account scope

All BVE Gateway keys share the same underlying Fuelix account. Files uploaded by one key are visible to all authenticated users of this gateway. Do not upload sensitive files.

List files

curl https://api.bve.me/v1/files \
  -H "Authorization: Bearer sk-bve-YOUR_KEY"

Response:

{
  "object": "list",
  "data": [
    {
      "id": "file-abc123",
      "object": "file",
      "bytes": 1024,
      "created_at": 1716288000,
      "filename": "training.jsonl",
      "purpose": "fine-tune"
    }
  ]
}

Optional query parameters: ?purpose=assistants

Upload a file

curl https://api.bve.me/v1/files \
  -H "Authorization: Bearer sk-bve-YOUR_KEY" \
  -F purpose="assistants" \
  -F file="@document.pdf"

Response:

{
  "id": "file-abc123",
  "object": "file",
  "bytes": 204800,
  "created_at": 1716288000,
  "filename": "document.pdf",
  "purpose": "assistants"
}

Get file metadata

curl https://api.bve.me/v1/files/file-abc123 \
  -H "Authorization: Bearer sk-bve-YOUR_KEY"

Delete a file

curl -X DELETE https://api.bve.me/v1/files/file-abc123 \
  -H "Authorization: Bearer sk-bve-YOUR_KEY"

Download file content

curl https://api.bve.me/v1/files/file-abc123/content \
  -H "Authorization: Bearer sk-bve-YOUR_KEY" \
  --output downloaded.pdf

SDK examples

Upload a file

TypeScript

import OpenAI from 'openai';
import fs from 'fs';

const client = new OpenAI({
  apiKey: 'sk-bve-YOUR_KEY',
  baseURL: 'https://api.bve.me/v1',
});

const file = await client.files.create({
  file: fs.createReadStream('document.pdf'),
  purpose: 'assistants',
});
console.log(file.id);

Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-bve-YOUR_KEY",
    base_url="https://api.bve.me/v1",
)

with open("document.pdf", "rb") as f:
    file = client.files.create(file=f, purpose="assistants")
print(file.id)

List and delete files

TypeScript

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-bve-YOUR_KEY',
  baseURL: 'https://api.bve.me/v1',
});

// List all files
const files = await client.files.list();
for (const f of files.data) {
  console.log(f.id, f.filename);
}

// Delete a file
await client.files.del('file-abc123');

Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-bve-YOUR_KEY",
    base_url="https://api.bve.me/v1",
)

# List all files
files = client.files.list()
for f in files.data:
    print(f.id, f.filename)

# Delete a file
client.files.delete("file-abc123")

Notes

• All standard OpenAI file operations are supported.
• Files are stored in the shared Fuelix upstream account.
• Do not upload personally identifiable information or credentials.

Next steps

Assistants Use uploaded files with assistants — code interpreter and file search tool

Vector Stores Build a searchable knowledge base from uploaded files

Rate Limits & Quotas Per-key request limits and Retry-After handling

Errors Full error code reference for pass-through API errors