# FLUX Kontext Max - Core.Today AI API

> A premium text-based image editing model that delivers maximum performance and improved typography generation for transforming images through natural language prompts.

- **Provider**: Black Forest Labs
- **Model ID**: black-forest-labs/flux-kontext-max
- **Category**: Image Generation
- **Credits**: 190 per image
- **Speed**: Medium
- **Quality**: Ultra

## Features
- Top-tier Kontext editing performance, above FLUX Kontext Pro
- Improved typography and text rendering in edited images
- Natural language instruction-based editing
- Aspect ratio auto-match to the input image
- Consistent character and style preservation across edits

## Use Cases
- Premium brand asset editing requiring precise typography
- Complex multi-step image transformations via natural language
- Style transfer and background changes for hero imagery
- High-stakes creative work where Kontext Pro quality is insufficient

## API Endpoint

Base URL: https://api.core.today/v1
Create Prediction: POST /predictions
Get Status: GET /predictions/{job_id}

## Authentication
Header: X-API-Key: YOUR_API_KEY

## Input Parameters

### Required
- **prompt**: string - Text description of what you want to generate, or the instruction on how to edit the given image

### Optional
- **input_image**: string - Image to use as reference. Must be jpeg, png, gif, or webp
- **aspect_ratio**: string (default: match_input_image) - Aspect ratio of the generated image. match_input_image matches the input image's ratio
  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 (default: png) - Output format for the generated image
  Options: jpg, png
- **safety_tolerance**: integer (default: 2) - Safety tolerance, 0 is most strict and 6 is most permissive. Max 2 when input images are used
- **prompt_upsampling**: boolean (default: false) - Automatic prompt improvement
- **seed**: integer - Random seed. Set for reproducible generation

## Examples

### 3D Typography Edit
Transform 2D text in a photo into a floating 3D effect
```json
{
  "model": "black-forest-labs/flux-kontext-max",
  "input": {
    "prompt": "Make the letters 3D, floating in space on a city street",
    "input_image": "https://replicate.delivery/xezq/XfwWjHJ7HfrmXE6ukuLVEpXWfeQ3PQeRI5mApuLXRxST7XMmC/tmpc91tlq20.png",
    "aspect_ratio": "match_input_image"
  }
}
```

## Response Format
```json
{
  "job_id": "abc123",
  "status": "pending | processing | completed | failed",
  "result": "URL or data (when completed)"
}
```

## Usage Flow
1. POST /predictions with model and input -> receive job_id
2. GET /predictions/{job_id} -> poll until status is completed or failed
3. Result contains output URL(s)

## Tips
- This is the top-tier Kontext model — use FLUX Kontext Pro first and reserve Max for edits that need the best typography and instruction fidelity
- safety_tolerance is capped at 2 whenever an input_image is supplied
- prompt_upsampling can improve results for short or vague editing instructions
- Use match_input_image (default) to preserve the source image's framing

## Documentation
https://replicate.com/black-forest-labs/flux-kontext-max