API keys#
Every request carries a bearer token minted in the dashboard under API Keys:
Authorization: Bearer ik_live_…
- The key is shown once at creation — store it in a secret manager, not in code.
- Each key is scoped to one project: it can only see and render that project’s templates and assets.
- Every render is logged against the key that made it.
- Revoke and re-mint from the same dashboard page at any time.
Addressing keys#
The template field in a render request takes the template’s addressing key:
{project_slug}_{frame_slug} → e.g. acme_instagram_1080x1350It is not a secret — it only means something to your bearer key’s project. GET /v1/templates returns the exact addressing key for every published template, so discover rather than construct them.
Rate limits#
| Limit | Rate | Notes |
|---|---|---|
per key | 10 req/s | Sustained, with bursts up to 30. One token per request. |
per account | 30 req/s | Sustained, with bursts up to 100 — shared across all keys. Renders consume tokens equal to their credit cost, so a scale-4 render draws 16. |
batch size | 50 rows | Maximum renders per batch request. |