Name: Flux Kontext Max – Edit Images with Text | $0.1/call | API.market
Brand: magicapi
SKU: api-magicapi-text-based-image-editor-black-forest-labs-flux-kontext-max
Availability: InStock
Author: API Market

Shashank Agarwal

# ✏️ Premium Text-Based Image Editor API (Flux Kontext Max)

## Overview
The Premium Text-Based Image Editor API (Flux Kontext Max) is a high-performance AI model developed by Black Forest Labs. It enables advanced image editing and transformation using natural language prompts. This API can interpret and apply text instructions to generate and modify images with improved typography and precision. Whether you require detailed image alterations or creative enhancements, this API offers maximum performance and high-quality results.

## Features

- **Natural Language Processing**: Transforms images based on detailed text prompts.
- **Image-to-Image Editing**: Allows you to edit existing images while preserving high fidelity.
- **Aspect Ratio Matching**: Matches the aspect ratio of the input image for consistent output.
- **Improved Typography Generation**: Enhances the quality and styling of text within images.
- **Multiple Output Formats**: Supports jpeg and png formats for versatile usage.
- **Safety Tolerance Control**: Configurable safety settings to ensure appropriate content.

## Use Cases

1. **E-commerce**: Create visually appealing product images by adding text instructions to highlight features or apply branding elements.
2. **Marketing and Advertising**: Generate promotional images with customized text to suit specific campaigns, enhancing engagement with target audiences.
3. **Social Media Management**: Create shareable and attractive posts by editing images to include relevant trendy captions or descriptions.
4. **Education**: Prepare visual content with detailed annotations for instructional materials.
5. **Design and Creativity**: Aid graphic designers in generating creative concepts by modifying images according to their textual descriptions.

## Visual Examples

### Overview Example
![Make the letters 3D, floating in space on a city street](https://blog.api.market/wp-content/uploads/2025/12/kontext-max-input-api-market.png)

### Endpoint Examples
#### Input Image
![Example Input Image](https://blog.api.market/wp-content/uploads/2025/12/kontext-max-input-api-market.png)

#### Output Image
![Example Output Image](https://blog.api.market/wp-content/uploads/2025/12/kontext-max-api-market.jpg)

## Pricing
- **Pay As You Go (PAYG) Pricing**: You only pay for the images processed.
- **1 API Unit Equals 1 Image Processed**.
- **Status Check GET Requests** are free and do not count toward API unit usage.
- **No Monthly Subscription Fees** or usage limits, offering a simple per-call pricing system.

## API Documentation
### Base URL
All API requests should be made to: 
```
https://prod.api.market/api/v1/magicapi/text-based-image-editor-black-forest-labs-flux-kontext-max
```

### Authentication
Authentication is handled via API key. Include your API key in the request header:
```
x-api-market-key: YOUR_API_MARKET_KEY
```

### Asynchronous Processing
**IMPORTANT**: This API uses asynchronous processing for predictions. The typical flow is:

1. Submit a prediction request to the POST endpoint.
2. Receive a prediction ID in the response.
3. Poll the GET endpoint with the prediction ID to check status.
4. Continue polling until the prediction is complete.

**Implementation Guide:**
- Polling interval of 1 second between status checks.
- Maximum timeout of 600 seconds (10 minutes).
- Handle errors when status becomes "failed" or timeout is reached.

### Endpoints
#### Create a Prediction
```bash
curl -X POST "https://prod.api.market/api/v1/magicapi/text-based-image-editor-black-forest-labs-flux-kontext-max/predictions" \
  -H "Content-Type: application/json" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  -d '{
    "version": "8389ed8e4b16016c44fcdcc3ad142cf1e182e0a1ecaf0347b3e5254303f2beac",
    "input": {
      "prompt": "Make the letters 3D, floating in space on a city street",
      "input_image": "https://blog.api.market/wp-content/uploads/2025/12/kontext-max-input-api-market.png",
      "aspect_ratio": "match_input_image",
      "output_format": "jpg"
    }
  }'
```

- **Response Example**:
```json
{
  "id": "ufawqhfynnddngldkgtslldrkq",
  "version": "8389ed8e4b16016c44fcdcc3ad142cf1e182e0a1ecaf0347b3e5254303f2beac",
  "status": "starting",
  "created_at": "2025-12-08T07:02:09.170Z"
}
```

#### Get Prediction Status and Results
```bash
curl -X GET "https://prod.api.market/api/v1/magicapi/text-based-image-editor-black-forest-labs-flux-kontext-max/predictions/ufawqhfynnddngldkgtslldrkq" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

- **Response Example**:
```json
{
  "id": "ufawqhfynnddngldkgtslldrkq",
  "status": "succeeded",
  "output": "https://blog.api.market/wp-content/uploads/2025/12/kontext-max-api-market.jpg",
  "created_at": "2023-01-01T12:00:00.000Z",
  "started_at": "2023-01-01T12:00:05.000Z",
  "completed_at": "2023-01-01T12:01:00.000Z"
}
```

## Status Codes

- **200 OK**: Request successful
- **201 Created**: Resource successfully created
- **400 Bad Request**: Invalid input parameters or malformed request
- **401 Unauthorized**: Missing or invalid API key
- **403 Forbidden**: Valid API key but insufficient permissions
- **404 Not Found**: Resource not found
- **429 Too Many Requests**: Rate limit exceeded
- **500 Internal Server Error**: Server-side error
- **503 Service Unavailable**: Service temporarily unavailable

## Rate Limits
Information about rate limits and how to handle them effectively. Ensure your application can gracefully retry calls with exponential backoff if rate limits are exceeded.

## Error Handling
### Common Errors:
- **Invalid Parameter**:
    - **Example**:
    ```json
    {
      "error": {
        "code": "invalid_parameter",
        "message": "The parameter 'image' is required",
        "status": 400
      }
    }
    ```

### Recommended Strategies:
- **Retry for Transient Errors**: Implement retries with incremental backoff.
- **Graceful Degradation**: Have fallbacks in case of repeated failures.

## Implementation Guide
### Example Code in Different Languages

#### JavaScript
```javascript
const apiKey = "YOUR_API_MARKET_KEY";
const baseUrl = "https://prod.api.market/api/v1/magicapi/text-based-image-editor-black-forest-labs-flux-kontext-max";

async function createAndWaitForPrediction(inputData) {
  try {
    const response = await fetch(`${baseUrl}/predictions`, {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "x-api-market-key": apiKey
      },
      body: JSON.stringify({ input: inputData })
    });

    if (!response.ok) {
      throw new Error(`API error: ${response.status} ${response.statusText}`);
    }

    const prediction = await response.json();
    const predictionId = prediction.id;
    return await pollForResults(predictionId);
  } catch (error) {
    console.error("Error:", error);
    throw error;
  }
}

function delay(ms) {
  return new Promise(resolve => setTimeout(resolve, ms));
}

async function pollForResults(predictionId) {
  const MAX_TIMEOUT = 600000;
  const POLL_INTERVAL = 1000;
  const startTime = Date.now();

  while (Date.now() - startTime < MAX_TIMEOUT) {
    const response = await fetch(`${baseUrl}/predictions/${predictionId}`, {
      headers: {
        "x-api-market-key": apiKey
      }
    });
    if (!response.ok) {
      throw new Error(`API error: ${response.status} ${response.statusText}`);
    }
    const prediction = await response.json();
    if (prediction.status === "succeeded") {
      return prediction.output;
    }
    if (prediction.status === "failed") {
      throw new Error(`Prediction failed: ${prediction.error || "Unknown error"}`);
    }
    await delay(POLL_INTERVAL);
  }
  throw new Error("Prediction timed out after 10 minutes");
}
```

#### Python
```python
import requests
import time

API_KEY = "YOUR_API_MARKET_KEY"
BASE_URL = "https://prod.api.market/api/v1/magicapi/text-based-image-editor-black-forest-labs-flux-kontext-max"

def create_and_wait_for_prediction(input_data):
    headers = {"Content-Type": "application/json", "x-api-market-key": API_KEY}
    response = requests.post(f"{BASE_URL}/predictions", headers=headers, json={"input": input_data})
    
    if response.status_code != 200:
        raise Exception(f"API error: {response.status_code} {response.text}")
    
    prediction = response.json()
    prediction_id = prediction["id"]
    return poll_for_results(prediction_id)

def poll_for_results(prediction_id):
    MAX_TIMEOUT = 600
    POLL_INTERVAL = 1

    headers = {"x-api-market-key": API_KEY}
    start_time = time.time()

    while time.time() - start_time < MAX_TIMEOUT:
        response = requests.get(f"{BASE_URL}/predictions/{prediction_id}", headers=headers)
        if response.status_code != 200:
            raise Exception(f"API error: {response.status_code} {response.text}")
        
        prediction = response.json()
        if prediction["status"] == "succeeded":
            return prediction["output"]
        if prediction["status"] == "failed":
            error_msg = prediction.get("error", "Unknown error")
            raise Exception(f"Prediction failed: {error_msg}")
        time.sleep(POLL_INTERVAL)
    raise Exception("Prediction timed out after 10 minutes")
```

#### cURL
```bash
# Create a prediction
curl -X POST "https://prod.api.market/api/v1/magicapi/text-based-image-editor-black-forest-labs-flux-kontext-max/predictions" \
  -H "Content-Type: application/json" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  -d '{
    "input": {
      "prompt": "Make the letters 3D, floating in space on a city street",
      "input_image": "https://blog.api.market/wp-content/uploads/2025/12/kontext-max-input-api-market.png",
      "aspect_ratio": "match_input_image",
      "output_format": "jpg",
      "safety_tolerance": 2
    }
  }'

# Replace ID with the actual prediction ID received
# Example ID: ufawqhfynnddngldkgtslldrkq
curl -X GET "https://prod.api.market/api/v1/magicapi/text-based-image-editor-black-forest-labs-flux-kontext-max/predictions/ufawqhfynnddngldkgtslldrkq" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

### Performance Optimization
- Optimize your image editing prompts for better performance.
- Utilize provided example inputs and outputs to understand the model's strengths.
- Monitor API usage to avoid hitting the rate limits.

## FAQ
### How do I get started with the API?
Sign up for an API.market account, obtain your API key, and follow the provided setup guides and examples.

### What image formats are supported?
The API supports jpeg and png formats for both input and output images.

### How can I optimize my usage and reduce costs?
Optimize your edits and use brief prompts where possible to reduce processing time and API calls.

## Contact Us
If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello[at]api.market.

Edit and transform images using natural language prompts. Preserves high fidelity and allows for advanced typography. Try it free on API.market.