Batch of 100 image covers on Sume: waves by plan, from Free to Scale

A 100-image batch fits one wave on Scale (120 accepted) but needs 5 waves on Pro (24 accepted). Capacity by plan, wave_size_hint and the 429 queue_full rule.

5 min readSume
All posts

A 100-image batch fits in one wave only on Scale, which accepts 120 jobs at once; Pro accepts 24, so it takes at least 5 waves. Sume admits work up to processing slots plus queue slots, and a request past that returns 429 queue_full. The jobs and results page lists the limits, and wave_size_hint tells you how many to send next.

The hint is max(1, floor(queue_capacity_remaining x 0.75)), so an idle Pro workspace sees 18, not 24.

What can each plan accept?

Accepted capacity is concurrency plus queue. The wave column is the hint on an idle workspace.

Image job admission by plan, read 2026-10-06
PlanConcurrencyQueueAcceptedIdle wave_size_hintWaves for 100
Free156425
Pro42024186
Startup84048363
Scale20100120902

How do I submit a wave?

Submit with mode: async, record the job ids, and wait until jobs reach terminal before the next wave. Poll /v1/jobs/{id}/status no sooner than next_poll_after_seconds. On a 429, wait and send the rest, not the whole batch again; use one Idempotency-Key per image so a resend does not bill twice.

Why not one big batch?

Rejected requests are not billed, but you lose time. Sizing waves from the hint keeps the queue full without hitting the cap.

Sources

Related posts

More in Developers

All Developers posts

Written by Sume