Credits and pricing

One credit pulls one image. Credits are prepaid and debited in real time as you download. Buy them in the portal at a flat per-image rate, in any amount.
Credits are charged per unique image, per account. You pay once per item id, and both credits and ownership are account-scoped, so they survive a key rotation. Re-downloading an item you already own is free: the response returns charged: false and already_owned: true, so pulling the same selection twice never double-charges.
To fetch only images you do not own yet, pass exclude_owned=true to /items. It also reports remaining/owned and a subset_exhausted message once you own the whole matching subset.
A download is charged only on success, and a retry with the same Idempotency-Key is never charged twice.
At a zero balance a live-tier download returns 402 (insufficient_credits) and delivers nothing. Top up in the portal.
Test downloads are free and never touch your balance.

NOTE

Downloads use a sign-then-debit flow: the credit is reserved, the signed URL is issued, and the balance is debited only once the URL is returned. A repeated request with the same Idempotency-Key returns the original result without a second charge.

PreviousAuthentication NextRate limits