API / Endpoints
Batch Processing
Create and manage batch jobs through the OpenAI-format endpoint.
Browse docs
Overview
Batch processing lets you submit asynchronous groups of requests. Batch jobs are created, polled, and canceled through the /v1/batches endpoints. Aurora proxies batch operations through its routing pipeline to the upstream provider.
Create a Batch
POST /v1/batches
text
curl http://your-aurora-host/v1/batches \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $AURORA_MASTER_KEY" \
-d '{
"input_file_id": "file-abc123",
"endpoint": "/v1/chat/completions",
"completion_window": "24h"
}'
Response:
text
{
"id": "batch-abc123",
"object": "batch",
"endpoint": "/v1/chat/completions",
"input_file_id": "file-abc123",
"completion_window": "24h",
"status": "validating",
"created_at": 1728000000
}
List Batches
GET /v1/batches
text
curl http://your-aurora-host/v1/batches \
-H "Authorization: Bearer $AURORA_MASTER_KEY"
Get Batch Status
GET /v1/batches/{id}
text
curl http://your-aurora-host/v1/batches/batch-abc123 \
-H "Authorization: Bearer $AURORA_MASTER_KEY"
Cancel a Batch
POST /v1/batches/{id}/cancel
text
curl -X POST http://your-aurora-host/v1/batches/batch-abc123/cancel \
-H "Authorization: Bearer $AURORA_MASTER_KEY"
Get Batch Results
GET /v1/batches/{id}/results
text
curl http://your-aurora-host/v1/batches/batch-abc123/results \
-H "Authorization: Bearer $AURORA_MASTER_KEY"