Create a batch

Creates and executes a batch from an uploaded dataset of requests

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Information about the batch. Must contain name, input_dataset_id, and model. Output-only fields are ignored.

namestringRequired

Batch name (e.g. foobar).

input_dataset_idstringRequired

ID of the dataset the batch reads inputs from.

modelstringRequired

The name of the model the batch uses.

statusenumOptionalDefaults to BATCH_STATUS_UNSPECIFIED

read-only. Current stage in the life-cycle of the batch.

A successful response.

batchobject

Information about the batch.

1	curl -X POST https://api.cohere.com/v2/batches \
2	-H "X-Client-Name: my-cool-project" \
3	-H "Authorization: Bearer <token>" \
4	-H "Content-Type: application/json" \
5	-d '{
6	"name": "foo",
7	"input_dataset_id": "foo",
8	"model": "foo"
9	}'

1	{
2	"batch": {
3	"name": "foo",
4	"input_dataset_id": "foo",
5	"model": "foo",
6	"id": "foo",
7	"creator_id": "foo",
8	"org_id": "foo",
9	"status": "BATCH_STATUS_UNSPECIFIED",
10	"created_at": "foo",
11	"updated_at": "foo",
12	"output_dataset_id": "foo",
13	"input_tokens": "foo",
14	"output_tokens": "foo",
15	"num_records": 42,
16	"num_successful_records": 42,
17	"num_failed_records": 42,
18	"status_reason": "foo"
19	}
20	}