Batches

​

Who can use them

​

Pricing

​

What an item looks like

• JSON only. Images go by url, or for the person by the id of a prior Upload Image. No file uploads in a batch.
• Garments only. Items whose product is not clothing fail with BATCH_PRODUCT_NOT_SUPPORTED, at no charge. Send those through Create Try-On.

​

Getting the results

• Webhooks. Every item sends its own generation.completed or generation.failed. Subscribe to batch.completed to hear when the whole batch is done.
• Polling. Get Batch works at any time, not only at the end: it returns the progress counts and every item so far, page by page, with resultImageUrl on the ones already done.

​

Cancelling and expiry

​

With the SDK

const batch = await client.batches.create({
  items: looks.map((look) => ({
    customId: look.sku,
    products: [{ externalId: look.sku }],
    person: { image: { source: { id: modelImageId } } },
  })),
});

// Later, or from your batch.completed webhook:
const items = await client.batches.items(batch.batchId);