Batch image processing API

This API is built for shops that push 50+ designs in a single call. POST /v1/batch accepts 1–50 images per request. Child jobs run in parallel under a single parent batch ID. The system is production-grade: predictable runtimes, parallel processing, and a single master ZIP for download.

Use it to generate wall art packages, poster files, clipart batches, or upscales. Each endpoint returns job status and a parent batch ID you can poll. The final package lands in R2 and is delivered as a presigned URL valid for 24 hours.

Four batch endpoints cover POD use cases:

• POST /v1/batch/clipart — submit 1–50 images for clipart batches.
• POST /v1/batch/wallart — create the 5-size wall art job (2:3, 3:4, 4:5, 11:14, ISO A1 at 300 DPI).
• POST /v1/batch/poster — create a single poster print file at 300 DPI (physical product).
• POST /v1/batch/upscale — upscale images across the batch.

You can also call POST /v1/batch as a generic entry point that routes to the correct job type based on payload fields.

Each batch request accepts 1–50 images. Send images as multipart form-data or remote URLs. Include a client_job_id to tie your system to the parent batch ID returned by the API. Requests that exceed 50 images are rejected.

Wall art jobs produce five print files at 300 DPI. Poster jobs produce one 300 DPI print file and require a shipping profile at the storefront (posters are physical products and do not get a Drive share link or customer PDF). Clipart batches can include 1–50 items and support optional watermarking and a batch-level Etsy listing PDF.

Each batch yields a parent batch ID and child job IDs. Child jobs run in parallel. When complete, Ratio Ready packages artifacts into a master ZIP stored in R2. The API returns presigned URLs valid for 24 hours to download the master ZIP and individual assets.

Wall art jobs include up to 20 mockups, a 15-second 1:1 listing video, a listing-copy PDF, and a Drive folder with a shareable link. Poster jobs return print files, mockups, video, and listing copy but not a Drive shareable link or customer PDF. Clipart batches include print files at 300 DPI, listing previews, optional watermark, and a batch-level Etsy listing PDF.

Use the free Make.com blueprint to automate uploads and webhooks. The blueprint runs on the Make.com free tier (1,000 ops/month) and sets up polling, job creation, and webhook wiring in 30–45 minutes. The REST API also works with n8n, Zapier, custom webhooks, and direct server-to-server calls.

Typical flow: upload images → POST /v1/batch/... → receive parent batch ID → poll or subscribe to webhooks → fetch master ZIP via presigned URL. Per-listing time on our side is 3–5 minutes processing after a 2-minute upload step from your system.

Pricing is credit-based. You get 75 free credits on signup. Wall art jobs cost 59 credits. Poster jobs cost 55 credits. Clipart batches start at 29 credits + 10 credits per additional 5 images. Use the REST API to create many listings; credits are deducted per job submitted.

These prices are supporting, not the pitch. For automated workflows, plan credits by job type and batch size. Contact support for volume plans or to integrate billing with your system.