Skip to main content
POST
Create a batch

Authorizations

Authorization
string
header
required

Your workspace API key, e.g. sk_sovereign_..., sent as Authorization: Bearer <key>.

Body

application/json
input_file_id
string
required

Id of a file uploaded via /v1/files with purpose "batch" containing the request JSONL. Must belong to this workspace (or be the input of one of its past batches); otherwise 404 "Input file not found".

endpoint
enum<string>
required

The API route every line in the file targets.

Available options:
/v1/chat/completions,
/v1/completions,
/v1/embeddings
model
string
required

A representative model id from the file; it is the billing-rate basis. Must have configured pricing or the call is refused with 400.

completion_window
string

How long the batch may take, e.g. "24h".

Response

201 with the batch object: { id, nebius_batch_id, endpoint, status, request_total, request_completed, request_failed, completion_window, billed_cost_usd, created_at, output_file_id, error_file_id, error }

The response is of type object.