Create Batch

API for Batch Processing. Available only for Scale and Enterprise plans.

This endpoint expects a multipart form containing a file.

inputfileRequired

JSON lines file containing batch requests. Minimum 20 records required. Maximum file size: 5MB. Maximum requests per batch: 500.

webhook_urlstringOptional

Optional webhook URL to receive batch completion notifications. A POST request will be sent when the batch completes or fails.

dry_runbooleanOptionalDefaults to false

When true, validates the input file without processing. Returns validation status without creating generations.

This endpoint returns an object.

Batch Responseobject

Validation Responseobject

1	from sync import Sync
2
3	client = Sync(
4	api_key="YOUR_API_KEY",
5	)
6	client.batch.create(
7	webhook_url="https://your-webhook-url.com/batch-webhook",
8	dry_run=False,
9	)

1	{
2	"id": "batch_abc123",
3	"created_at": "2024-01-15T10:30:00Z",
4	"status": "PENDING",
5	"metrics": {
6	"total_generations": 5,
7	"success_count": 0,
8	"failed_count": 0,
9	"pending_count": 0
10	},
11	"webhookUrl": "https://your-webhook-url.com/batch-webhook",
12	"outputUrl": ""
13	}