Name: Flux Kontext – Text-Guided Image Editing | From $40/mo | API.market
Brand: magicapi
SKU: api-magicapi-context-aware-text-to-image-api-black-forest-labs-flux-kontext-dev
Availability: InStock
Author: API Market

Shashank Agarwal

# 🖼️ Context-Aware Text-to-Image API (Flux Kontext Dev)

## Overview
The Context-Aware Text-to-Image API (Flux Kontext Dev) by Black Forest Labs is a state-of-the-art image editing model that enables you to edit images using text prompts. It excels in text-guided image editing and provides superior results. This API allows you to perform various image manipulations like style transfer, object/clothing changes, text editing, background swapping, and more with high-speed processing and exceptional context understanding. It is particularly powerful for maintaining character consistency across edits, offering commercial-grade outputs suitable for apps, marketing, and business use.

## Features
- **Style Transfer:** Convert photos to various art styles (e.g., watercolor, oil painting, sketches).
- **Object/Clothing Changes:** Modify hairstyles, add accessories, change clothing colors.
- **Text Editing:** Replace text in signs, posters, and labels.
- **Background Swapping:** Change environments while keeping subjects in place.
- **Character Consistency:** Maintain identity across multiple edits.

## Use Cases
1. **E-Commerce:** Automatically generate product images in different styles or with different backgrounds for online stores.
2. **Digital Marketing:** Create customized promotional images quickly by altering existing visuals with text prompts.
3. **Gaming Industry:** Develop consistent character images by modifying in-game characters' appearance while maintaining their identity.
4. **Movie Production:** Simplify the process of background adjustments or prop changes in scene images.
5. **Educational Materials:** Efficiently produce labeled and styled educational images by altering text and aesthetics through prompts.

## Visual Examples
### Example 1
*Prompt:* "Change the car color to red, turn the headlights on"

**Input Image:**
![Input Image (Original Car)](https://blog.api.market/wp-content/uploads/2026/01/car-api-market-scaled.jpg)

**Output Image:**
![Output Image (Red Car with Headlights On)](https://blog.api.market/wp-content/uploads/2026/01/output-car-api-market.jpg)

## Pricing
- **Pay As You Go (PAYG):** Pay only for what you use.
- **API Unit:** 1 image processed equals 1 API unit.
- **Free GET Requests:** Checking prediction status is free and doesn't count toward API unit usage.
- **No Subscriptions or Limits:** No monthly fees or usage limits – simple per-call pricing.

## API Documentation

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

### Authentication
Use your API key in the request header:
```
x-api-market-key: YOUR_API_MARKET_KEY
```

### Asynchronous Processing
This API uses asynchronous processing. 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.

**Polling interval:** Use a 1-second interval between status checks.
**Timeout:** Apply a maximum timeout of 600 seconds (10 minutes).

### Endpoints

#### Create Prediction
```bash
curl -X POST "https://prod.api.market/api/v1/magicapi/context-aware-text-to-image-api-black-forest-labs-flux-kontext-dev/predictions" \
  -H "Content-Type: application/json" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  -d '{
        "input": {
            "prompt": "Change the car color to red, turn the headlights on",
            "input_image": "https://blog.api.market/wp-content/uploads/2026/01/car-api-market-scaled.jpg"
        }
      }'
```
**Response Example:**
```json
{
  "id": "ufawqhfynnddngldkgtslldrkq",
  "status": "starting",
  "created_at": "2025-09-04T17:11:37.414Z"
}
```

#### Check Prediction Status
```bash
curl -X GET "https://prod.api.market/api/v1/magicapi/context-aware-text-to-image-api-black-forest-labs-flux-kontext-dev/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/2026/01/output-car-api-market.jpg",
  "created_at": "2025-09-04T17:11:37.414Z",
  "started_at": "2025-09-04T17:11:37.414Z",
  "completed_at": "2025-09-04T17:12:37.414Z"
}
```

## 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
- There is a rate limit to ensure fair usage and prevent abuse.
- Use appropriate retry strategies if rate limits are exceeded.

## Error Handling
- **Interpret error responses:** Check error codes and messages.
- **Common errors:** Invalid input parameters, unauthorized access, rate limit exceeded.
- **Retry strategies:** Implement exponential backoff for transient errors.

**Error Response Example:**
```json
{
  "error": {
    "code": "invalid_parameter",
    "message": "The parameter 'image' is required",
    "status": 400
  }
}
```

## Implementation Guide

### Example Code
#### JavaScript
```javascript
const apiKey = "YOUR_API_MARKET_KEY";
const baseUrl = "https://prod.api.market/api/v1/magicapi/context-aware-text-to-image-api-black-forest-labs-flux-kontext-dev";

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/context-aware-text-to-image-api-black-forest-labs-flux-kontext-dev"

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")
```

```bash
# Step 1: Create a prediction
curl -X POST "https://prod.api.market/api/v1/magicapi/context-aware-text-to-image-api-black-forest-labs-flux-kontext-dev/predictions" \
  -H "Content-Type: application/json" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  -d '{
        "input": {
            "prompt": "Change the car color to red, turn the headlights on",
            "input_image": "https://blog.api.market/wp-content/uploads/2026/01/car-api-market-scaled.jpg"
        }
      }'

# Step 2: Check prediction status (replace abcd1234 with the actual ID)
curl -X GET "https://prod.api.market/api/v1/magicapi/context-aware-text-to-image-api-black-forest-labs-flux-kontext-dev/predictions/abcd1234" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

### Performance Optimization
- Use specific and descriptive prompts for better results.
- Break down complex edits into smaller steps.
- Adjust guidance and inference steps for desired quality and speed.

## FAQ
**Q:** What image formats are supported for input?  
**A:** The API supports jpeg, png, gif, and webp formats.

**Q:** How long does it take to process a request?  
**A:** Processing time varies based on the complexity of the request. Average time is between 10-60 seconds.

**Q:** Can I use the images generated by the API for commercial purposes?  
**A:** Yes, the API outputs can be used commercially in apps, marketing, and any business use.

## 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 generate images with text prompts. Maintains character consistency for style transfer, object swaps & more. Try it free on API.market.

Flux Kontext – Text-Guided Image Editing | From $40/mo | API.market