Files API — Upload and Manage Files for Batch Jobs

The Files API provides storage for the JSONL input files that power Meliai’s Batch API. Before you can create a batch job, you must upload a JSONL file containing all the individual inference requests you want to process. Meliai stores the file on your behalf, returns a file_id, and lets you list, inspect, download, and delete your files at any time. All files are scoped to your API key and never leave EU infrastructure.

Endpoints

Method	Path	Description
POST	/v1/files	Upload a file
GET	/v1/files	List files
GET	/v1/files/	Get file metadata
GET	/v1/files//content	Download file content
DELETE	/v1/files/	Delete a file

Upload a File

Upload a JSONL file that will serve as input to a batch job. The request must be sent as multipart/form-data. POST /v1/files

file

required

The JSONL file to upload. Each line must be a valid JSON object representing a single inference request. See the Batch API input format for the required schema.

string

required

The intended use for the file. Currently the only accepted value is "batch".

curl https://api.meliai.ai/v1/files \
  -H "Authorization: Bearer $MELIAI_API_KEY" \
  -F purpose=batch \
  -F file=@requests.jsonl

import openai

client = openai.OpenAI(
    api_key="sk-mel-<KEY>",
    base_url="https://api.meliai.ai/v1",
)

with open("requests.jsonl", "rb") as f:
    file_obj = client.files.create(file=f, purpose="batch")

print(file_obj.id)  # file-abc123

import OpenAI from "openai";
import fs from "fs";

const client = new OpenAI({
  apiKey: "sk-mel-<KEY>",
  baseURL: "https://api.meliai.ai/v1",
});

const fileObj = await client.files.create({
  file: fs.createReadStream("requests.jsonl"),
  purpose: "batch",
});
console.log(fileObj.id); // file-abc123

The response includes the id field you pass to POST /v1/batches as input_file_id.

List Files

Retrieve all files uploaded to your account, ordered by creation time. GET /v1/files

curl https://api.meliai.ai/v1/files \
  -H "Authorization: Bearer $MELIAI_API_KEY"

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

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

Get File Metadata

Retrieve metadata for a specific file without downloading its content. GET /v1/files/{id}

curl https://api.meliai.ai/v1/files/file-abc123 \
  -H "Authorization: Bearer $MELIAI_API_KEY"

meta = client.files.retrieve("file-abc123")
print(meta.filename, meta.bytes, meta.status)

const meta = await client.files.retrieve("file-abc123");
console.log(meta.filename, meta.bytes, meta.status);

Download File Content

Download the raw content of a file. Use this to retrieve output JSONL files once a batch job has completed. GET /v1/files/{id}/content

curl https://api.meliai.ai/v1/files/file-abc123/content \
  -H "Authorization: Bearer $MELIAI_API_KEY" \
  -o results.jsonl

content = client.files.content("file-abc123")
with open("results.jsonl", "wb") as f:
    f.write(content.read())

const content = await client.files.content("file-abc123");
const text = await content.text();
require("fs").writeFileSync("results.jsonl", text);

Delete a File

Permanently delete a file from your account. This action cannot be undone. Deleting a file that is referenced by an active batch job will cause that job to fail. DELETE /v1/files/{id}

curl -X DELETE https://api.meliai.ai/v1/files/file-abc123 \
  -H "Authorization: Bearer $MELIAI_API_KEY"

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

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

A successful deletion returns a confirmation object:

{
  "id": "file-abc123",
  "object": "file",
  "deleted": true
}

Deleting an input file while a batch job referencing it is still in_progress will cause the batch to transition to failed. Always wait for batch jobs to complete before deleting their associated input files.

Overview

Inference

Batch & Files

Models

Files API — Upload and Manage Files for Batch Jobs

Endpoints

Upload a File

List Files

Get File Metadata

Download File Content

Delete a File

​Endpoints

​Upload a File

​List Files

​Get File Metadata

​Download File Content

​Delete a File

Endpoints

Upload a File

List Files

Get File Metadata

Download File Content

Delete a File