Image Generation

Flux Edit (Kontext) API

Black Forest Labs FLUX.1 Kontext for text-driven image editing. Dev (open-weight), Pro (state-of-the-art), and Max (premium typography). Integrate this model via REST with endpoint docs, parameters, and code examples.

Prompting guide Compare image models Use cases

Img2Img

Credit Cost

1 credit

Type

Image

Get API Key

Create auth keys for apps and agents

See Usage

Track requests, credits, and logs

Buy Credits

Top up prepaid API capacity

API Endpoint

POST

/api/v1/models/flux-edit/run

Test This Model

Run a real request through the API pipeline and inspect the exact input and output your integration will handle. Uses your credits like any API call; failed runs are refunded automatically.

LLM.txt

AI-Ready

For AI assistants

Copy this model's documentation into Claude, GPT, or any AI for instant integration help.

/llm/flux-edit.txt

OpenAPI Spec

Swagger compatible

Import into Postman, Swagger UI, or generate client SDKs in any language.

/api/openapi

Parameters

Input parameters accepted by this model

Parameter	Type	Description	Default
`prompt` required	string	Text instruction describing what to generate or edit.	-
`input_image`	url	Reference image URL.	-
`input_image_1`	string	Primary reference image URL (multi-image edit). Required when not using the legacy `input_image` field.	-
`input_image_2`	string	Optional second reference image URL — bias the edit with an additional context image. Not supported on the "dev" model.	-
`aspect_ratio`	enum	Output aspect ratio. `1:116:99:1621:99:21`+7 more	`match_input_image`
`seed`	integer	Random seed for reproducibility. Same seed + inputs yields similar results.	-
`output_format`	enum	Output file format. `pngjpgwebp`	`png`
`safety_tolerance`	integer	Content filter strictness (1=strict, 5=permissive). min: 0 \| max: 6	`2`
`model`	enum	Model variant to use. `devpromax`	`dev`
`num_inference_steps`	integer	Number of denoising steps. More steps = higher fidelity, slower. min: 1 \| max: 50	`30`
`guidance`	number	Classifier-free guidance scale. Higher = stricter prompt adherence. min: 0 \| max: 10	`2.5`
`output_quality`	integer	JPEG/WEBP encoding quality (0–100). min: 1 \| max: 100	`100`

Use saved characters (@Name)

This model takes no reference images, so @Name of a saved character is refused (400) before anything is charged. A saved location, prop or style with a description is inserted as text. For saved characters, use a model that takes reference images, such as Nano Banana Pro or Seedream 5 for images, or Seedance 2.5 or WAN 3.0 for video.

Example Outputs

Real outputs generated by this model

Flux Edit (Kontext) example: Make it a rainy evening: warm lamplight inside the shop, rain streaking the windows, and dress her in a bright yellow...

View Details

Make it a rainy evening: warm lamplight inside the shop, rain streaking the windows, and dress her in a bright yellow raincoat.

1 credit

95.9s

Code Examples

Basic edit — copy and paste to get started

bash

curl -X POST "https://pixeldojo.ai/api/v1/models/flux-edit/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "make the sky stormy",
    "input_image_1": "https://...",
    "model": "pro"
  }'

Response Format

Submit Response (202 Accepted)

json

{
  "jobId": "job_abc123...",
  "status": "pending",
  "statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123...",
  "creditCost": 1,
  "creditsRemaining": 95,
  "expiresAt": "2026-10-10T02:49:10Z"
}

Completed Response