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.

API keys are part of the Business plan ($199.99/mo) and above.

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.
• OpenAPI specEvery route and model input in one OpenAPI 3.1 file, ready for SDK generators and agents.

Pricing

API keys are part of the Business plan ($199.99/mo) and above. The API bills in credits, at the same rate as the studios. Every model lists its credit cost before you call it, credits for a failed generation are restored automatically, and add-on credits never expire.