# FLUX Kontext Pro

> A state-of-the-art text-based image editing model that delivers high-quality outputs with excellent prompt following and consistent results for transforming images through natural language. Supports style transfer, object modification, text replacement, background changes, and character consistency.

- **Provider**: replicate
- **Model ID**: black-forest-labs/flux-kontext-pro
- **Category**: image_generation
- **Credits**: 120 per request
- **Pricing Type**: fixed

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `aspect_ratio` (string, optional): Aspect ratio of the generated image. Use 'match_input_image' to match the aspect ratio of the input image. (Default: `match_input_image`; Options: `match_input_image`, `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`, `4:5`, `5:4`, `21:9`, `9:21`, `2:1`, `1:2`)
- `output_format` (string, optional): Output format for the generated image (Default: `png`; Options: `jpg`, `png`)
- `seed` (integer, optional): Random seed. Set for reproducible generation
- `safety_tolerance` (integer, optional): Safety tolerance, 0 is most strict and 6 is most permissive. 2 is the maximum allowed when input images are used. (Default: `2`; Range: min: 0, max: 6)
- `prompt_upsampling` (boolean, optional): Automatic prompt improvement (Default: `False`)
- `input_image` (string, optional): Image to use as reference. Must be jpeg, png, gif, or webp.
- `prompt` (string, **required**): Text description of what you want to generate, or the instruction on how to edit the given image

## Example Request

```json
{
  "model": "black-forest-labs/flux-kontext-pro",
  "input": {
    "prompt": "Make this a 90s cartoon",
    "input_image": "https://replicate.delivery/pbxt/N55l5TWGh8mSlNzW8usReoaNhGbFwvLeZR3TX1NL4pd2Wtfv/replicate-prediction-f2d25rg6gnrma0cq257vdw2n4c.png",
    "aspect_ratio": "match_input_image",
    "safety_tolerance": 2,
    "prompt_upsampling": false,
    "output_format": "jpg"
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "black-forest-labs/flux-schnell",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Output Type

url

## Tags

flux, image-editing, text-to-image, style-transfer, image-transformation, character-consistency, black-forest-labs

## Documentation

https://replicate.com/black-forest-labs/flux-kontext-pro