Name: Flux Kontext – Restore & Colorize Photos | $0.05/call | API.market
Brand: magicapi
SKU: api-magicapi-ai-photo-restoration-colorization
Availability: InStock
Rating: 5.00 (2 reviews)
Author: API Market

Shashank Agarwal

# 🧑‍🎨 AI Photo Restoration & Colorizer API (Flux Kontext)

## Overview
The AI Photo Restoration & Colorizer API (Flux Kontext) is designed to quickly restore and colorize old or damaged photos. Simply provide an input image (JPEG, PNG, GIF, or WebP), and the API applies state-of-the-art transformations to remove defects, repair scratches, and breathe new life into black-and-white or faded images with realistic colorization. 

This API is especially helpful for photographers, historians, genealogists, and anyone looking to preserve and modernize old photographs efficiently and at scale.

## Features
- Image Restoration: Automatically remove scratches, dust, and common defects.
- Colorization: Transform black-and-white images into color photos with realistic coloring.
- High-Quality Output: Produces professional-grade restoration results with minimal artifacts.
- Flexible Output: Choose output formats (JPG or PNG) to suit your workflow.
- Asynchronous Processing: Submit a request and poll for results, ensuring stability and scalability.

## Use Cases

1. Genealogy & Family Archives  
   Enhance, restore, and colorize vintage family photographs. Perfect for genealogical research, family reunions, and heirloom preservation.

2. Museum & Historical Preservation  
   Archives and museums can use this API to revitalize torn or faded historical images, making them more appealing for exhibits and digital records.

3. Photography Studios  
   Photographers offering restoration services can automate the process to handle large volumes of damaged or old photos without manual intervention.

4. Publishing & Media  
   Publishers can bring historical articles to life by colorizing black-and-white photos, improving the visual storytelling in print and digital media.

5. E-commerce & Marketplace Sellers  
   Sellers of vintage items can quickly restore images of old collectibles or antiques, helping customers see products in a clearer, more appealing light.

## Visual Examples

Below is an example of an old or damaged image (input) and the restored, colorized image (output). The actual images shown here are for illustrative purposes and demonstrate the transformation this API can perform.

### Example Input Image
![Black and white photo with scratches and damage](https://replicate.delivery/mgxm/b033ff07-1d2e-4768-a137-6c16b5ed4bed/d_1.png)

### Example Output Image
![Restored and colorized version of the photo](https://replicate.delivery/xezq/VjZzUS8uxOobNpyJzFebvWiuUa3Bzs60RQOexLVQIOuewckpA/tmpio8e0bce.png)

These examples illustrate how the API can remove scratches and add color while preserving important details.

## Pricing
- 1 API unit equals 1 image processed.
- GET requests to check prediction status (GET /api/v1/magicapi/ai-photo-restoration-colorization/predictions/{id}) are free and do not count toward API unit usage.
- Different pricing tiers are available based on your monthly or annual usage volume.

Contact sales or check the pricing page on API.market for the latest tier information.

## API Documentation

Below is a comprehensive guide to using the AI Photo Restoration & Colorizer API.

### Base URL
All requests should be made to:
```
https://prod.api.market/api/v1/magicapi/ai-photo-restoration-colorization
```

### Authentication
Include your API key in the request header:
```
x-magicapi-key: YOUR_API_MARKET_KEY
```

Make sure your key is kept private. Each request must include this header to be authorized.

### Asynchronous Processing
This API uses an asynchronous process for photo restoration and colorization:

1. Send a POST request to create a prediction.
2. Receive a unique prediction ID.
3. Poll the GET endpoint with the prediction ID to check the status.
4. Continue polling until the status is "succeeded" or "failed."

Recommended polling approach:
- Poll every 1 second.
- Stop polling after 600 seconds (10 minutes) to avoid indefinite waiting.
- When status is "succeeded," retrieve the output from the response.
- When status is "failed," handle the error accordingly.

### Endpoints

#### Create a Prediction
• Method: POST  
• Endpoint: /api/v1/magicapi/ai-photo-restoration-colorization/predictions  
• Description: Initiates a restoration & colorization job.

Example request body (JSON):
```json
{
  "version": "85ae46551612b8f778348846b6ce1ce1b340e384fe2062399c0c412be29e107d",
  "input": {
    "input_image": "https://replicate.delivery/mgxm/b033ff07-1d2e-4768-a137-6c16b5ed4bed/d_1.png"
  }
}
```

Example cURL:
```bash
curl -X POST "https://prod.api.market/api/v1/magicapi/ai-photo-restoration-colorization/predictions" \
  -H "Content-Type: application/json" \
  -H "x-magicapi-key: YOUR_API_MARKET_KEY" \
  -d '{
    "version": "85ae46551612b8f778348846b6ce1ce1b340e384fe2062399c0c412be29e107d",
    "input": {
      "input_image": "https://replicate.delivery/mgxm/b033ff07-1d2e-4768-a137-6c16b5ed4bed/d_1.png"
    }
  }'
```

Successful response (HTTP 201) example:
```json
{
  "id": "ufawqhfynnddngldkgtslldrkq",
  "version": "85ae46551612b8f778348846b6ce1ce1b340e384fe2062399c0c412be29e107d",
  "status": "starting",
  "created_at": "2025-06-05T20:18:37.358Z"
}
```

#### Get Prediction Status & Results
• Method: GET  
• Endpoint: /api/v1/magicapi/ai-photo-restoration-colorization/predictions/{id}  
• Description: Retrieves the status and, if available, the result of a prediction.

Example cURL:
```bash
curl -X GET "https://prod.api.market/api/v1/magicapi/ai-photo-restoration-colorization/predictions/ufawqhfynnddngldkgtslldrkq" \
  -H "x-magicapi-key: YOUR_API_MARKET_KEY"
```

Successful response (HTTP 200) example (when completed):
```json
{
  "id": "ufawqhfynnddngldkgtslldrkq",
  "status": "succeeded",
  "output": "https://replicate.delivery/xezq/VjZzUS8uxOobNpyJzFebvWiuUa3Bzs60RQOexLVQIOuewckpA/tmpio8e0bce.png",
  "error": null,
  "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 succeeded, and the response contains the requested data.
- 201 Created: The resource was successfully created (e.g., a new prediction).
- 400 Bad Request: Invalid input parameters or malformed request. Check your JSON structure and required fields.
- 401 Unauthorized: No valid API key was provided, or the key is incorrect.
- 403 Forbidden: The API key is valid but lacks sufficient permissions for the request.
- 404 Not Found: The requested resource was not found (e.g., invalid prediction ID).
- 429 Too Many Requests: Rate limit exceeded. Wait before sending another request.
- 500 Internal Server Error: A server-side error occurred. Contact support if this persists.
- 503 Service Unavailable: The service is currently overloaded or down for maintenance.

### Rate Limits
Your plan may include specific rate limits. If you exceed them, you may receive 429 responses. Implement a backoff strategy if you get these responses, and consider upgrading your plan if you frequently hit rate limits.

### Error Handling
When the API returns an error, it includes a JSON response body that can help identify the problem. For example:

```json
{
  "error": {
    "code": "invalid_parameter",
    "message": "The parameter 'input_image' is required",
    "status": 400
  }
}
```

Best practices include:
- Logging the entire error response.
- Retrying only when it makes sense (e.g., 429 Too Many Requests or 5xx errors).
- Correcting input errors (e.g., missing fields or invalid URLs) and retrying.

### Performance Optimization
- Adjust polling frequency if needed; 1 second is typically sufficient while staying responsive.  
- If handling large volumes, consider batching requests according to your rate limits.  
- Leverage caching of restored images to avoid repeating work for the same input.

## FAQ

1. **Which image formats are accepted?**  
   Supported formats include JPEG, PNG, GIF, or WebP.

2. **How long does it take to restore a photo?**  
   Most requests complete in a few seconds, but it can take up to a few minutes depending on image complexity and traffic.

3. **What is the maximum resolution supported?**  
   The recommended maximum resolution is 4K (3840x2160). Larger images may still work but could increase processing time or cause errors due to memory limits.

4. **Can I keep the original resolution after restoration?**  
   Yes, the API preserves the original dimensions unless specified otherwise.

5. **How do I handle errors or failed predictions?**  
   Check the error message in the response. Fix any invalid parameters and retry. If the issue persists, contact support.

## 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. 

We’re here to help you get the most out of the AI Photo Restoration & Colorizer API (Flux Kontext). Happy coding!

Restore, repair, and colorize old or damaged photos with AI. Removes scratches & defects. From $0.05/call. Try it free on API.market.

Flux Kontext – Restore & Colorize Photos | $0.05/call | API.market

🧑‍🎨 AI Photo Restoration & Colorizer API (Flux Kontext)

PAYG

MagicAPI

This API gives one of the best results that I have seen so far. 