Skip to main content
POST
/
images
/
edit
Typescript (SDK)
import { Crevio } from "@crevio/sdk";

const crevio = new Crevio({
  apiKey: process.env["CREVIO_API_KEY"] ?? "",
});

async function run() {
  const result = await crevio.images.edit({
    input: {
      prompt: "Place the product on a marble countertop with soft morning light",
      imageUrl: "https://example.com/product.jpg",
    },
  });

  console.log(result);
}

run();
{
  "id": "<string>",
  "object": "<string>",
  "type": "<string>",
  "model": "<string>",
  "progress": 123,
  "input": {},
  "result": {},
  "error": "<string>",
  "error_code": "<string>",
  "credits_used": 123,
  "provider_request_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "started_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

API key in the format: Bearer {api_token}

Body

application/json
​
input
object
required

Model-specific input, forwarded to fal verbatim. prompt and a source image (image_url or image_urls) are required. Either image field is accepted regardless of model — it is normalized to whichever the chosen model expects.

​
model
enum<string>

fal.ai model id. Defaults to fal-ai/nano-banana/edit.

Available options:
fal-ai/nano-banana/edit,
fal-ai/nano-banana-pro/edit,
fal-ai/flux-pro/kontext,
fal-ai/flux/dev/image-to-image

Response

Edit job queued

​
id
string
required
​
object
string
required
​
type
string
required
​
status
enum<string>
required
Available options:
queued,
processing,
completed,
failed,
cancelled
​
model
string
required
​
progress
integer
required
​
input
object
required
​
result
object
required
​
error
string | null
required
​
error_code
string | null
required
​
credits_used
integer | null
required
​
provider_request_id
string | null
required
​
created_at
string<date-time>
required
​
started_at
string<date-time> | null
required
​
completed_at
string<date-time> | null
required