The Imagera API

Authenticate with an Authorization: Key header, name a model, describe what you want.

export IMAGERA_API_KEY="ima_sk_YOUR_KEY"

curl -X POST "https://api.imagera.ai/v1/queue/imagera-image-generate" \
  -H "Authorization: Key $IMAGERA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "a lighthouse at dusk, long exposure"
}'

Submit answers 202 Accepted, not an image — the body carries a request_id and a status_url to follow. Hold onto that request_id and poll it. Send an Idempotency-Key on the submit and a retry returns the original response instead of starting a second billed generation — the replay is marked with an Idempotency-Replayed header, and the key holds for 24 hours.

What the API gives you

• One balance, not two

  API calls draw from the same credits as the studios. Nothing to top up separately, nothing that expires on a different clock.

• Safe retries

  Send an Idempotency-Key and a retried submit returns the original response instead of starting — and billing — a second generation. Same key with a different body is rejected rather than quietly honoured.

• Errors you can act on

  Failures come back as RFC 9457 problem documents with a stable machine-readable code, and a rate limit carries Retry-After — so backing off is arithmetic, not guesswork.

• Signed webhooks

  Get a signed callback when a generation finishes, so you never have to poll a long-running video job.

• Revoke in seconds

  Keys are revocable per integration and stop working within 60 seconds, so a leak costs you a minute, not a month.

Where to go next

• API keysCreate a key, copy it once, and revoke it the moment it leaks.
• UsageRequests, credits and concurrency for every key on your account.
• MCP serverConnect Imagera to an AI assistant that speaks Model Context Protocol.

Pricing

The API bills in credits, at the same rate as the studios. Every model lists its credit cost before you call it, and a failed generation is refunded automatically. Bring an existing plan or top up with credits that never expire.