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.

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

OpenAI SDK

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

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

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

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

// Delete
await client.files.del(file.id);

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.