Images

Edit an image

Submits an asynchronous image-to-image (editing) job to the fal.ai queue and returns the queued job immediately. Transforms one or more source images according to a text prompt — restyle a product photo, change a background, combine references. Poll GET /v1/jobs/{id} for status and results. Credits are charged only when the job completes successfully.

post/images/edit

Request

  • Base URL: https://api.crevio.co/v1
  • URL: https://api.crevio.co/v1/images/edit
  • 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-to-image endpoint id. Prefer a tier — it tracks the best current model for that price point. Defaults to fal-ai/nano-banana/edit.

Example request

{
  "model": "fast"
}

Response

Edit 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.