Create a batch

POST

https://api.empiriolabs.ai/v1/batches

Create a batch from an uploaded input file. Requests are processed asynchronously within the completion window and billed at 35% off each model’s list price. Only batch-eligible models may be used (check batch_supported on /v1/models).

Authentication

AuthorizationBearer

Pass your EmpirioLabs API key as a bearer token. The Anthropic-style x-api-key header is also accepted on every endpoint.

Request

This endpoint expects an object.

input_file_idstringRequired

endpointenumOptionalDefaults to /v1/chat/completions

Allowed values:

completion_windowstringOptionalDefaults to 24h

metadataobjectOptional

Response

Batch created.

idstringOptional

objectstringOptional

endpointstringOptional

input_file_idstringOptional

completion_windowstringOptional

statusenumOptional

output_file_idstring or nullOptional

error_file_idstring or nullOptional

request_countsobjectOptional

metadataobject or nullOptional

created_atinteger or nullOptional

completed_atinteger or nullOptional

expires_atinteger or nullOptional

$	curl -X POST https://api.empiriolabs.ai/v1/batches \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"input_file_id": "file_8a7f3c2d9b1e4f6a8c3d2e1f"
>	}'

1	{
2	"id": "batch_497c277b51594a8e8e6c474d92fb4b41",
3	"object": "batch",
4	"endpoint": "/v1/chat/completions",
5	"input_file_id": "file_8a7f3c2d9b1e4f6a8c3d2e1f",
6	"completion_window": "24h",
7	"status": "validating",
8	"output_file_id": "file_9b8e7d6c5a4f3e2d1c0b9a8f",
9	"error_file_id": "file_0a1b2c3d4e5f6789abcdef01",
10	"request_counts": {
11	"total": 100,
12	"completed": 75,
13	"failed": 5
14	},
15	"metadata": {},
16	"created_at": 1711507200,
17	"completed_at": 1711593600,
18	"expires_at": 1712188800
19	}