Images

Generate an image

Submits an asynchronous image generation job to the fal.ai queue and returns the queued job immediately. Poll GET /v1/jobs/{id} for status and results. Credits are charged only when the job completes successfully.

post/images/generate

Request

  • Base URL: https://api.crevio.co/v1
  • URL: https://api.crevio.co/v1/images/generate
  • Auth: API key in header Authorization

Headers

Idempotency-Keystring

Makes this write safe to retry: a repeat with the same key replays the first response instead of creating a second resource. Scoped to the account, remembered for 24 hours; reusing a key with a different payload is an error.

Request body

modelstring

A quality tier (fast, balanced, quality) or any fal.ai image endpoint id. Prefer a tier — it tracks the best current model for that price point. Defaults to fal-ai/nano-banana-2; GET /v1/images/models maps tiers to ids with live pricing.

Example request

{
  "model": "fast"
}

Response

Generation job queued

idstring required
objectstring required
typestring required
status'queued' | 'processing' | 'completed' | 'failed' | 'cancelled' required
modelstring required
progressinteger required
inputobject required
resultobject nullable required
errorstring nullable required
error_codestring nullable required
credits_usedinteger nullable required
provider_request_idstring nullable required
created_atstring date-time required
started_atstring date-time nullable required
completed_atstring date-time nullable required

Changes

No recorded changes to this operation across all 2 revisions of this API.