v1

latestOpenAPI 3.1.02026-07-26105141.0 KB

Batches API

Create a batch

Submit a batch of requests for asynchronous processing.

post/batches

Headers

Idempotency-Keystring

Makes the request retry-safe. Sail stores a reservation keyed by (organization, API key, Idempotency-Key); retrying with the same value returns the previously stored response instead of re-running inference. Keys are capped at 255 characters. See Idempotent Requests for full semantics.

Request body

endpoint'/v1/responses' required

The API endpoint to use for all requests in the batch. Currently only /v1/responses is supported.

labelstring

An optional label for the batch. Must be alphanumeric (hyphens and underscores allowed), max 128 characters.

Response

Batch created.

idstring required

Unique identifier for the batch.

request_countsinteger required

Total number of requests in the batch.

created_atinteger required

Unix timestamp of when the batch was created.

labelstring

The label for the batch, if provided.