Name: Flux Kontext Pro – Text-Based Image Editing | $0.05/call | API.market
Brand: magicapi
SKU: api-magicapi-ai-text-based-image-editing-api
Availability: InStock
Rating: 3.50 (2 reviews)
Author: API Market

Shashank Agarwal

# 🖌️ Text-Based Image Editing API (Flux Kontext Pro)

## Overview
The Text-Based Image Editing API (Flux Kontext Pro) enables you to edit and transform images using natural language prompts. Powered by advanced AI image processing, it delivers consistent, high-quality output based on your specific text instructions—ideal for everything from subtle retouching to generating entirely new visuals from a single image.

## Features
- Transform images using simple text-based commands  
- High-quality, consistent editing results  
- Flexible aspect ratio support including matching the input image  
- Multiple output formats (JPG, PNG)  
- Controllable safety tolerance for content filtering  

## Use Cases
1. Creative Advertisement Mockups: Marketing teams can quickly generate different versions of ad visuals by describing the desired style or thematic changes without needing to manually edit images.  
2. Fashion & E-commerce Product Enhancement: Retailers can instantly alter backgrounds or styling of product photos for different campaigns or seasonal trends using simple prompts.  
3. Social Media Content Creation: Influencers can easily transform selfies or scenic photos into stylized images (e.g., “90s cartoon” or “futuristic city”) to stand out on social platforms.  
4. Architecture & Interior Design Previews: Quickly transform images of rooms or buildings to showcase different design styles or color schemes, all through textual instructions.  
5. Game & Film Concept Art: Artists and concept designers can rapidly iterate on character or environment designs by describing new visual traits or themes.

## Visual Examples
Below is an example of how the API transforms images based on textual instructions:

### Example Prompt
"Make the person hold an iPad instead of a notebook.."

### Input Image
![Original image to be transformed](https://blog.api.market/wp-content/uploads/2025/06/person_with_notebook-scaled.jpeg)

### Output Image
![Transformed image in 90s cartoon style](https://blog.api.market/wp-content/uploads/2025/06/tmpg36x__gu.png)

These examples showcase how you can easily create a specific look or style. The API processes your input image and prompt to deliver the final output image.

## Pricing
• 1 API unit equals 1 image processed.  
• GET requests to check the status of a prediction (GET /api/v1/magicapi/ai-text-based-image-editing-api/predictions/{id}) are free and do not count toward API usage.  
• Various pricing tiers are available based on usage volume (contact us for details).

## API Documentation

### Base URL
All requests should be made to:  
https://prod.api.market/api/v1/magicapi/ai-text-based-image-editing-api

### Authentication
Include your API key in the request header:
```
x-magicapi-key: YOUR_API_MARKET_KEY
```
Replace YOUR_API_MARKET_KEY with the API key you received from API.market.

### Asynchronous Processing
This API processes image edits asynchronously:

1. POST a new prediction request.  
2. Receive a prediction ID in the immediate response.  
3. Use the GET endpoint with the prediction ID to check the status.  
4. Continue polling until the status becomes "succeeded" or "failed."

Allow a reasonable polling interval (e.g., 1 second) and a timeout of up to 600 seconds (10 minutes) for completion. The status can be:
- starting  
- processing  
- succeeded  
- failed  
- canceled  

### Endpoints

#### 1. Create a Prediction

• Method: POST  
• Endpoint: /api/v1/magicapi/ai-text-based-image-editing-api/predictions  
• Purpose: Creates a new prediction (image transformation request).

Example Request (JSON):
```json
{
  "version": "15589a1a9e6b240d246752fc688267b847db4858910cc390794703384b6a5443",
  "input": {
    "prompt": "Make the person hold an iPad instead of a notebook.",
    "input_image": "https://blog.api.market/wp-content/uploads/2025/06/person_with_notebook-scaled.jpeg",
    "aspect_ratio": "match_input_image",
    "output_format": "jpg",
    "safety_tolerance": 2
  }
}
```

Example cURL:
```bash
curl -X POST "https://prod.api.market/api/v1/magicapi/ai-text-based-image-editing-api/predictions" \
  -H "Content-Type: application/json" \
  -H "x-magicapi-key: YOUR_API_MARKET_KEY" \
  -d '{
    "version": "15589a1a9e6b240d246752fc688267b847db4858910cc390794703384b6a5443",
    "input": {
      "prompt": "Make the person hold an iPad instead of a notebook.",
      "input_image": "https://blog.api.market/wp-content/uploads/2025/06/person_with_notebook-scaled.jpeg",
      "aspect_ratio": "match_input_image",
      "output_format": "jpg",
      "safety_tolerance": 2
    }
  }'
```

Example Response (201 Created):
```json
{
  "id": "ufawqhfynnddngldkgtslldrkq",
  "version": "15589a1a9e6b240d246752fc688267b847db4858910cc390794703384b6a5443",
  "status": "starting",
  "created_at": "2025-06-05T17:59:54.327Z"
}
```

#### 2. Get Prediction Status/Result

• Method: GET  
• Endpoint: /api/v1/magicapi/ai-text-based-image-editing-api/predictions/{id}  
• Purpose: Checks the status of a previously created prediction and returns the result if completed.

Example cURL:
```bash
curl -X GET "https://prod.api.market/api/v1/magicapi/ai-text-based-image-editing-api/predictions/ufawqhfynnddngldkgtslldrkq" \
  -H "x-magicapi-key: YOUR_API_MARKET_KEY"
```

Example Response (200 OK - succeeded):
```json
{
  "id": "ufawqhfynnddngldkgtslldrkq",
  "status": "succeeded",
  "output": "https://blog.api.market/wp-content/uploads/2025/06/tmpg36x__gu.png",
  "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: The request was successful.  
• 201 Created: Resource was successfully created (e.g., a new prediction).  
• 400 Bad Request: Invalid input parameters or malformed request.  
• 401 Unauthorized: Missing or invalid API key.  
• 403 Forbidden: The API key is valid, but the request is not permitted.  
• 404 Not Found: The requested resource does not exist.  
• 429 Too Many Requests: Rate limit exceeded; retry after some time.  
• 500 Internal Server Error: Something went wrong on the server.  
• 503 Service Unavailable: The service is temporarily unavailable; try again later.

## Rate Limits
The API may enforce rate limits to ensure fair usage. If you exceed the allowable request rate, you may receive a 429 Too Many Requests response. In such cases, implement an exponential backoff strategy and wait before retrying.

## Error Handling
When an error occurs, the API returns a JSON response with an error message and HTTP status code. For instance:
```json
{
  "error": {
    "code": "invalid_parameter",
    "message": "The parameter 'input_image' is required",
    "status": 400
  }
}
```
Steps to handle errors:
1. Check the error code and message to identify the issue.  
2. Correct the input parameters if the error is due to invalid data.  
3. Re-authenticate or regenerate your API key if you see a 401 Unauthorized.  
4. Implement retries with a backoff strategy for transient errors (429 or 500 series).

#### cURL
```bash
# 1. Create a prediction
curl -X POST "https://prod.api.market/api/v1/magicapi/ai-text-based-image-editing-api/predictions" \
  -H "Content-Type: application/json" \
  -H "x-magicapi-key: YOUR_API_MARKET_KEY" \
  -d '{
    "version": "15589a1a9e6b240d246752fc688267b847db4858910cc390794703384b6a5443",
    "input": {
      "prompt": "Make the person hold an iPad instead of a notebook.",
      "input_image": "https://blog.api.market/wp-content/uploads/2025/06/person_with_notebook-scaled.jpeg"
    }
  }'

# Response will look like:
# {"id": "abcd1234", "status": "starting", "version": "15589a1a9e6..."}

# 2. Check status with the returned ID
curl -X GET "https://prod.api.market/api/v1/magicapi/ai-text-based-image-editing-api/predictions/abcd1234" \
  -H "x-magicapi-key: YOUR_API_MARKET_KEY"

# Poll until "status": "succeeded" or "failed".
```

### Performance Optimization
1. Batch requests if you have multiple images to process.  
2. Use appropriate aspect ratios and image sizes—larger images may take longer to process.  
3. Cache processed results to avoid reprocessing the same inputs.  
4. Respect the polling interval so the API is not overloaded, and your application remains responsive.

## FAQ
1. Q: How long does a typical image transformation take?  
   A: It varies based on image size and complexity. Most requests complete within a few seconds, but can take up to a minute or more.  

2. Q: Is there a limit on image size or resolution?  
   A: Maximum dimensions may vary based on your plan. For optimal performance, keep images under 4K resolution.  

3. Q: Can I transform multiple images in a single request?  
   A: Each request processes exactly one image. You may submit multiple requests in parallel up to your plan limits.  

4. Q: What if my transformation returns undesired results?  
   A: Adjust your prompt or use different parameters such as aspect ratio or safety tolerance.  

5. Q: Does the safety_tolerance parameter block certain content?  
   A: A lower number enforces stricter content checks. At higher values, fewer restrictions are applied.  

## 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. Get consistent, high-quality results for everything from retouching to Try it free on API.market.

Flux Kontext Pro – Text-Based Image Editing | $0.05/call | API.market

🖌️ Text-Based Image Editing API (Flux Kontext Pro)

PAYG

MagicAPI

Wow, this works for a huge range of use-cases. I was able to remove objects, add glasses and much more. Amazing.

Half working. 
Getting Bad Gateway error 50% of the time.

Bad gateway - the service failed to handle your request
api.market | 502: Bad gateway Bad gateway Error code 502 Visit cloudflare.com for more information. 2025-07-17 10:52:49 UTC You Browser Working San Jose Cloudflare Working prod.api.market Host Error What happened?
The web server reported a bad gateway error.
What can I do?
Please try again in a few minutes.





Edit and transform images using natural language prompts with high-quality, consistent output—ideal for instant, precise, and controllable image edits.