When to use solve_batch
2026-03-19 · Using the API
Use a batch when you already have many images. Do not use it to retry one image.
POST /v1/solve_batch accepts up to 256 images. Top-level options apply to every item, and an item can override them. Results are in the same order as the request.
Each item is charged on its own. One bad image does not blank the batch. Read reliable on each result.
A plain base64 string is shorthand for an item that is only an image. An object is how you set per-item options.
413 means the body was too large. On Lambda the practical cap is 6 MB. Split the batch. 429 means too many calls are already in flight for this key.
Ready to call it? Start with the quickstart, the API guide, or pricing.