Thursday, July 3, 2025

New: ImagineAPI Enhance — Upscale up to 12x

Gezim Hoxha

Prompt: A crystal-clear mountain landscape at sunrise

I'm thrilled to announce a powerful new feature for ImagineAPI.dev: High-Resolution Image Upscaling! You can now enhance your generated images up to 12x their original resolution using our advanced AI upscaling technology.

What's New?

Our new upscaling API leverages state-of-the-art AI models to intelligently enhance image resolution while preserving and even improving details. Whether you need a higher resolution for print, web display, or further editing, our upscaling feature has you covered.

Key Features:

- Multiple Scale Factors: Choose from 2x, 4x, 6x, 8x, 10x, or 12x upscaling
- Credit-Based System: Transparent pricing with credits based on scale factor
- Asynchronous Processing: Non-blocking API with webhook support
- Smart Enhancement: AI-powered detail preservation and enhancement
- Format Optimization: Output in efficient WebP format

How to Use It

Step 1: Generate or Get Id of Existing Image

First, ensure you have an image that has been generated through our API. Each generated image will have upscaled_urls containing the available images for upscaling.

Step 2: Call the Upscale Endpoint

Use our new upscale endpoint to enhance your image:

curl -X POST -H 'Content-Type: application/json' \
-H 'Authorization: Bearer YOUR_API_KEY' \
'https://cl.imagineapi.dev/items/images/{IMAGE_ID}/{IMAGE_INDEX}/upscale/{SCALE}'

# example: upscale 2x the firt image (index 0) of image object with id 88391189-2b24-468c-96ce-ee47c4cb404d
curl -H 'Content-Type: application/json' \
-H 'Authorization: Bearer <API_KEY>' \
-X POST 'https://cl.imagineapi.dev/items/images/88391189-2b24-468c-96ce-ee47c4cb404d/0/upscale/2x'

This will create a new image object with an `id` and `parent_id` will be the image id of image object you just upscaled (in our example: 88391189-2b24-468c-96ce-ee47c4cb404d).

URL Parameters:

IMAGE_ID: The uuid of the generated image
IMAGE_INDEX: If the image has multiple results, this is the index of the actual image you're upscaling
SCALE: The upscaling factor - "2x", "4x", "6x", "8x", "10x", or "12x"
Step 3: Track Progress

Visual explanation of IMAGE_INDEX:

The API will return a new image object with status: "pending". parent_id is the id of the image object this upscale was generated from. upscaled_index is the image_index as seen in the image above.

Response:

Response format for upscaled image

{
  "data": {
    "error": null,
    "id": "53b1d01e-12de-413e-b94d-a562270e89f6",
    "status": "pending",
    "progress": null,
    "ref": null,
    "url": null,
    "parent_id": "88391189-2b24-468c-96ce-ee47c4cb404d",
    "date_created": "2025-07-03T23:51:51Z",
    "integration_id": null,
    "model_type": "Enhance",
    "upscale_factor": 2,
    "upscaled_index": 0,
    "user_created": "10e9477b-3bdc-4a58-8996-b387aed12029"
  }
}

Step 3: Track Progress

You can poll the image endpoint or use webhooks to track completion:

curl -H 'Authorization: Bearer YOUR_API_KEY' \
'https://cl.imagineapi.dev/items/images/{UPSCALED_IMAGE_ID}'

# example get results of upscaled image 53b1d01e-12de-413e-b94d-a562270e89f6
curl -H 'Authorization: Bearer <API_KEY>' \
                                                   'https://cl.imagineapi.dev/items/images/53b1d01e-12de-413e-b94d-a562270e89f6'

{
  "data": {
    "error": null,
    "id": "53b1d01e-12de-413e-b94d-a562270e89f6",
    "status": "completed",
    "progress": null,
    "ref": null,
    "url": "https://cdn.imagineapi.dev/assets/1b3e1ad1-5ca6-4811-bc78-8ad6d63e3887/fcaec06f-5107-4773-a31c-608bcecee61d.webp",
    "parent_id": "88391189-2b24-468c-96ce-ee47c4cb404d",
    "date_created": "2025-07-03T23:51:51Z",
    "integration_id": null,
    "model_type": "Enhance",
    "upscale_factor": 2,
    "upscaled_index": 0,
    "user_created": "<YOUR_USER_ID>"
  }
}

`url` has the image url you can use directly on your website/app.

Credit System

Upscaling uses a credit-based system where higher scale factors require more credits:

| Scale Factor | Credits Required |
|-------------|------------------|
| 2x | 3 credits |
| 4x | 10 credits |
| 6x | 35 credits |
| 8x | 45 credits |
| 10x | 80 credits |
| 12x | 100 credits |

1 credit is $0.01

Note: Credits are deducted when the upscaling job starts and automatically refunded if the process fails.

Best Practices

1. Start Small: Test with 2x or 4x upscaling before jumping to higher resolutions
2. Choose the Right Image: Select the best variant from your generated images
3. Monitor Credits: Keep track of your credit balance for larger upscaling operations
4. Use Webhooks: Implement webhook handlers for production applications
5. Handle Errors: Implement retry logic for failed upscaling attempts

Get Started Today!

Ready to enhance your images? Here's how to get started:

1. Ensure you have an active subscription at imagineapi.dev/integrations
2. Check your credit balance in your dashboard
3. Start upscaling your images using the API

We can't wait to see the amazing high-resolution images you'll create!

---

Happy upscaling! 🚀

Back to blog