Image

Flux Pro Kontext

Credit-based pricing. Supports reference images, batch up to 4.

Try Flux Pro Kontext →Compare models

Output

image

Aspect ratio

1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3

Max batch

Inputs

Reference image (required)

Batch up to 4 per request

Example prompt

Move the cat to sit on top of the bookshelf instead of the floor, keep everything else identical

Try this prompt →

LLM-ready

API & LLM schema

Exact request contract for this model. Agents can fetch it from /api/v1/models?id=fal-ai/flux-pro/kontext.

POST/api/v1/generate15 fields · 3 required

Field	Type	Requirement	Contract
`model_id`	constant	Required	ArtEmotion model identifier.
`extra`	object	Optional	Model-specific settings may also be nested here.
`max_credits`	number	Optional	Reject before submission if the estimated list price exceeds this cap. · Range: 1–…
`webhook_url`	string	Optional	Format: uri
`webhook_secret`	string	Optional	Optional model input.
`folder_id`	string	Optional	Optional model input.
`prompt`	string	Required	Optional model input.
`enhance_prompt`	boolean	Optional	Whether to enhance the prompt for better results. · Default: false
`seed`	integer	Optional	The same seed and the same prompt given to the same version of the model will output the same image every time.
`safety_tolerance`	number	Optional	The safety tolerance level for the generated image. 1 being the most strict and 5 being the most permissive. · Allowed: 1, 2, 3, 4, 5, 6 · Default: 2
`guidance_scale`	number	Optional	The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show · Default: 3.5 · Range: 1–20
`aspect_ratio`	string	Optional	Allowed: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3
`output_format`	string	Optional	Allowed: jpeg, png
`num_images`	integer	Optional	Range: 1–4
`reference_image_url`	string	Required	Format: uri

Minimal request example

{
  "model_id": "fal-ai/flux-pro/kontext",
  "prompt": "Move the cat to sit on top of the bookshelf instead of the floor, keep everything else identical",
  "reference_image_url": "https://example.com/reference_image"
}

Raw JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fflux-pro%2Fkontext",
  "title": "Flux Pro Kontext generation request",
  "description": "Request body accepted by POST /api/v1/generate for fal-ai/flux-pro/kontext.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "fal-ai/flux-pro/kontext",
      "description": "ArtEmotion model identifier."
    },
    "extra": {
      "type": "object",
      "additionalProperties": true,
      "description": "Model-specific settings may also be nested here."
    },
    "max_credits": {
      "type": "number",
      "minimum": 1,
      "description": "Reject before submission if the estimated list price exceeds this cap."
    },
    "webhook_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048
    },
    "webhook_secret": {
      "type": "string",
      "maxLength": 512
    },
    "folder_id": {
      "type": "string"
    },
    "prompt": {
      "type": "string"
    },
    "enhance_prompt": {
      "title": "Enhance Prompt",
      "description": "Whether to enhance the prompt for better results.",
      "default": false,
      "type": "boolean"
    },
    "seed": {
      "title": "Seed",
      "description": "The same seed and the same prompt given to the same version of the model will output the same image every time.",
      "type": "integer"
    },
    "safety_tolerance": {
      "title": "Safety Tolerance",
      "description": "The safety tolerance level for the generated image. 1 being the most strict and 5 being the most permissive.",
      "default": "2",
      "type": "number",
      "enum": [
        1,
        2,
        3,
        4,
        5,
        6
      ]
    },
    "guidance_scale": {
      "title": "Guidance Scale",
      "description": "The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show",
      "default": 3.5,
      "type": "number",
      "minimum": 1,
      "maximum": 20,
      "multipleOf": 0.1
    },
    "aspect_ratio": {
      "type": "string",
      "enum": [
        "1:1",
        "16:9",
        "9:16",
        "4:3",
        "3:4",
        "3:2",
        "2:3"
      ]
    },
    "output_format": {
      "type": "string",
      "enum": [
        "jpeg",
        "png"
      ]
    },
    "num_images": {
      "type": "integer",
      "minimum": 1,
      "maximum": 4
    },
    "reference_image_url": {
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "model_id",
    "prompt",
    "reference_image_url"
  ],
  "additionalProperties": false
}

Browse schemas for every ArtEmotion model →

FAQ

How much does Flux Pro Kontext cost on ArtEmotion?

Credit-based pricing. You pay in ArtEmotion credits — every plan and top-up converts USD to credits at a fixed rate.

Do I get my credits back if Flux Pro Kontext fails?

Yes — failed generations are never charged. The credits are released back to your balance automatically.

Can I call Flux Pro Kontext from the API?

Yes. Use POST /api/v1/generate with model_id: "fal-ai/flux-pro/kontext". See the API reference for the full schema.

Where are my generations stored?

Every output is saved to your personal Library. You can export or delete everything any time from Privacy & deletion.

Ready to generate with Flux Pro Kontext?

Start now →

No commitment. New accounts get 50 free credits on signup. See pricing.