Upload file

from cerebras.cloud.sdk import Cerebras
import os

client = Cerebras(
    api_key=os.environ.get("CEREBRAS_API_KEY"),
)

file = client.files.create(
    file=open("batch-requests.jsonl", "rb"),
    purpose="batch"
)

print(file)

import Cerebras from '@cerebras/cerebras_cloud_sdk';
import * as fs from 'fs';

const client = new Cerebras({
  apiKey: process.env['CEREBRAS_API_KEY'],
});

async function main() {
  const file = await client.files.create({
    file: fs.createReadStream("batch-requests.jsonl"),
    purpose: "batch"
  });

  console.log(file);
}

main();

curl --location 'https://api.cerebras.ai/v1/files' \
--header "Authorization: Bearer ${CEREBRAS_API_KEY}" \
--form 'file=@"batch-requests.jsonl"' \
--form 'purpose="batch"'

{
  "id": "fileI72lQshwSO6Z7LIQ850CvA",
  "object": "file",
  "filename": "test.jsonl",
  "bytes": 4213,
  "purpose": "batch",
  "created_at": 1765172961,
  "expires_at": 1767764961
}

POST

files

from cerebras.cloud.sdk import Cerebras
import os

client = Cerebras(
    api_key=os.environ.get("CEREBRAS_API_KEY"),
)

file = client.files.create(
    file=open("batch-requests.jsonl", "rb"),
    purpose="batch"
)

print(file)

import Cerebras from '@cerebras/cerebras_cloud_sdk';
import * as fs from 'fs';

const client = new Cerebras({
  apiKey: process.env['CEREBRAS_API_KEY'],
});

async function main() {
  const file = await client.files.create({
    file: fs.createReadStream("batch-requests.jsonl"),
    purpose: "batch"
  });

  console.log(file);
}

main();

curl --location 'https://api.cerebras.ai/v1/files' \
--header "Authorization: Bearer ${CEREBRAS_API_KEY}" \
--form 'file=@"batch-requests.jsonl"' \
--form 'purpose="batch"'

{
  "id": "fileI72lQshwSO6Z7LIQ850CvA",
  "object": "file",
  "filename": "test.jsonl",
  "bytes": 4213,
  "purpose": "batch",
  "created_at": 1765172961,
  "expires_at": 1767764961
}

This feature is in Private Preview. For access or more information, contact us or reach out to your account representative.

Uploads a file for use with the Batch API. Files can be up to 200 MB and must be JSONL format. Files are retained for 7 days by default.

Request

file

required

The file to upload. Must be a binary file.

string

required

The intended purpose of the file. Currently supported values:

batch: Input file for batch processing

object

The expiration policy for the file. Files with purpose=batch expire after 7 days by default.

Show properties

string

required

Anchor timestamp after which the expiration policy applies. Must be created_at.

integer

required

The number of seconds after the anchor point when the file expires. Must be between 3600 (1 hour) and 2592000 (30 days).

Response

string

A unique identifier for the file.

string

The object type, which is always file.

string

The name of the uploaded file.

string

The intended purpose of the file.

integer

The size of the file in bytes.

integer

The Unix timestamp (in seconds) of when the file was created.

integer

The Unix timestamp (in seconds) of when the file will be automatically deleted.

from cerebras.cloud.sdk import Cerebras
import os

client = Cerebras(
    api_key=os.environ.get("CEREBRAS_API_KEY"),
)

file = client.files.create(
    file=open("batch-requests.jsonl", "rb"),
    purpose="batch"
)

print(file)

import Cerebras from '@cerebras/cerebras_cloud_sdk';
import * as fs from 'fs';

const client = new Cerebras({
  apiKey: process.env['CEREBRAS_API_KEY'],
});

async function main() {
  const file = await client.files.create({
    file: fs.createReadStream("batch-requests.jsonl"),
    purpose: "batch"
  });

  console.log(file);
}

main();

curl --location 'https://api.cerebras.ai/v1/files' \
--header "Authorization: Bearer ${CEREBRAS_API_KEY}" \
--form 'file=@"batch-requests.jsonl"' \
--form 'purpose="batch"'

{
  "id": "fileI72lQshwSO6Z7LIQ850CvA",
  "object": "file",
  "filename": "test.jsonl",
  "bytes": 4213,
  "purpose": "batch",
  "created_at": 1765172961,
  "expires_at": 1767764961
}

Cancel batch

List files

⌘I

Introduction

Chat

Completions

Models

Batch

Files

Metrics

Management

Request

Response

​Request

​Response

Request

Response