Generate or Edit Image

POST

/api/v1/flux/kontext/generate

Create a new image generation or editing task using the Flux Kontext AI model.

Usage Modes

Text-to-Image Generation

Provide prompt and aspectRatio

Model will generate a new image based on the text description

Image Editing

Provide prompt and inputImage

You can optionally provide an aspectRatio.

If supplied, the output will be cropped or padded to match this ratio.

If omitted, the original image's ratio will be preserved.

Model will edit the input image according to the prompt

Important Notes

Generated images will expire after 14 days

Prompts only support English

Choose the appropriate model based on your needs:

flux-kontext-pro: Standard model for most use cases

flux-kontext-max: Enhanced model for complex scenes

Callbacks

onImageGenerated

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Request successful

Body

🔴500Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.kie.ai/api/v1/flux/kontext/generate' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "A serene mountain landscape at sunset with a lake reflecting the orange sky",
    "enableTranslation": true,
    "aspectRatio": "16:9",
    "outputFormat": "jpeg",
    "promptUpsampling": false,
    "model": "flux-kontext-pro"
}'

Response Example

200 - 成功示例

{
    "code": 200,
    "msg": "success",
    "data": {
        "taskId": "task12345"
    }
}

Image Generation or Editing Callbacks

Get Image Details