跳转到主要内容
POST
Create a batch

授权

Authorization
string
header
必填

Your API key, sent as Authorization: Bearer <key>.

请求体

application/json
items
object[]
必填
Required array length: 1 - 10000 elements

One task of a batch: the fields of a single task request, plus an optional customId. webhook is set once on the batch.

webhook
object

Each item's task posts its result here, and the batch posts one batch.completed event when it finishes.

metadata
object

Up to 8 KB of JSON, returned with the batch.

idempotencyKey
string

Sending the same key again within 30 days of the first batch's createdAt returns that batch; after that it returns 409 RESOURCE_ALREADY_EXISTS.

Maximum string length: 256

响应

A batch with this idempotencyKey was created in the last 30 days; it is returned unchanged.

success
boolean
必填
batch
object
必填