POST
/v1/batchesBatches
Async bulk processing at 50% off. Submit a JSONL file, get results within 24h.
Request
- HTTP
- POST
- URL
- /v1/batches
- Auth
- api_key
Try it
curl https://api.fightclub.pro/v1/batches \
-H "Authorization: Bearer $FC_API_KEY" \
-d '{"input_file_id":"file_abc","endpoint":"/v1/chat/completions","completion_window":"24h"}'Parameters
| Name | Type | Description |
|---|---|---|
| input_file_id* | string | A previously uploaded file with purpose=batch. |
| endpoint* | string | "/v1/chat/completions" | "/v1/embeddings" | "/v1/moderations". |
| completion_window | string | Always "24h" for v1. |
Response fields
| Name | Type | Description |
|---|---|---|
| id | string | Batch ID (batch_*). |
| status | string | validating | in_progress | finalizing | completed | failed. |
| output_file_id | string | Set when completed. |
Errors
- 401
invalid_api_key, Missing or revoked key. - 400
invalid_input_file, File missing or wrong purpose.
See the full error reference.