Stable Image - Image Upscaler
Upscale and enhance image quality using Stability AI's advanced upscaling technology. Increase image resolution by 4x while preserving details and improving overall image quality using predictive and generative AI algorithms.
Endpoint
Request Headers
| Field | Value |
|---|---|
| API-KEY | <api-key> |
| Content-Type | application/json |
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
type | string | Yes | Feature type identifier. Must be IMAGE_UPSCALER |
model | string | Yes | AI model identifier. Must be stable-image |
promptObject | object | Yes | Configuration object containing all upscaling parameters |
Prompt Object Parameters
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
imageUrl | string | Yes | Path to the image to be upscaled | - |
output_format | string | No | Output format for the upscaled image | png |
Supported Output Formats
| Format | Description | Best For |
|---|---|---|
png | High quality, lossless compression | Detailed images, graphics with transparency |
jpeg | Smaller file size, slight compression | Photographs, web images |
webp | Modern format, excellent compression | Web applications, modern browsers |
Code Examples
- cURL
- JavaScript
- Python
curl --location 'https://api.1min.ai/api/features' \
--header 'API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"type": "IMAGE_UPSCALER",
"model": "stable-image",
"promptObject": {
"imageUrl": "images/2025_10_26_05_43_42_184_cat.png",
"output_format": "png"
}
}'
fetch('https://api.1min.ai/api/features', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'API-KEY': 'YOUR_API_KEY'
},
body: JSON.stringify({
type: 'IMAGE_UPSCALER',
model: 'stable-image',
promptObject: {
imageUrl: 'images/2025_10_26_05_43_42_184_cat.png',
output_format: 'png'
}
})
})
import requests
url = "https://api.1min.ai/api/features"
headers = {
"Content-Type": "application/json",
"API-KEY": "YOUR_API_KEY"
}
data = {
"type": "IMAGE_UPSCALER",
"model": "stable-image",
"promptObject": {
"imageUrl": "images/2025_10_26_05_43_42_184_cat.png",
"output_format": "png"
}
}
response = requests.post(url, headers=headers, json=data)
Interactive Playground
API Playground
https://api.1min.ai/api/featuresPath to the image file to be upscaled
Format of the upscaled image
Generated cURL Command:
curl -X POST "https://api.1min.ai/api/features" \
-H "API-KEY: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"type": "IMAGE_UPSCALER",
"model": "stable-image",
"promptObject": {
"imageUrl": "images/2025_10_26_05_43_42_184_cat.png",
"output_format": "png"
}
}'
Response Format
{
"aiRecord": {
"uuid": "u1v2w3x4-y5z6-7890-abcd-ef1234567890",
"userId": "user-12345",
"teamId": "team-67890",
"teamUser": {
"teamId": "team-67890",
"userId": "user-12345",
"userName": "John Doe",
"userAvatar": "https://example.com/avatar.jpg",
"status": "ACTIVE",
"role": "ADMIN",
"creditLimit": 100000000,
"usedCredit": 30000,
"createdAt": "2025-01-01T00:00:00.000Z",
"createdBy": "SYSTEM",
"updatedAt": "2025-01-15T12:00:00.000Z",
"updatedBy": "SYSTEM"
},
"model": "stable-image",
"type": "IMAGE_UPSCALER",
"metadata": null,
"rating": null,
"feedback": null,
"conversationId": null,
"status": "SUCCESS",
"createdAt": "2025-01-15T12:00:00.000Z",
"aiRecordDetail": {
"promptObject": {
"imageUrl": "images/2025_10_26_05_43_42_184_cat.png",
"output_format": "png"
},
"resultObject": [
"development/images/2025_01_15_12_00_30_001_cat_upscaled.png"
],
"responseObject": {}
},
"additionalData": null,
"temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/images/2025_01_15_12_00_30_001_cat_upscaled.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=EXAMPLE_CREDENTIAL&X-Amz-Date=20250115T120000Z&X-Amz-Expires=604800&X-Amz-Signature=example_signature&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject"
}
}
Use Cases
Image Enhancement & Restoration
- Photo Enhancement: Improve quality of old or low-resolution photographs
- Digital Art Upscaling: Enhance pixel art and digital illustrations
- Document Scanning: Improve clarity of scanned documents and images
- Thumbnail Enhancement: Create high-resolution versions from small images
- Archive Restoration: Restore and enhance historical images
Professional Applications
- Print Preparation: Upscale images for high-resolution printing
- Web Optimization: Create multiple resolution versions for responsive design
- Marketing Materials: Enhance images for professional presentations
- E-commerce: Improve product image quality for online stores
- Gaming Assets: Upscale textures and sprites for modern displays
Creative & Artistic
- Digital Photography: Enhance resolution while preserving artistic intent
- Graphic Design: Prepare low-res assets for high-resolution projects
- Animation: Upscale frame sequences for higher quality output
- Social Media: Create crisp, high-quality images for platforms
- Portfolio Work: Enhance artwork for professional presentation
Tips for Best Results
-
Input Quality: Start with the highest quality source image available
- Higher quality inputs produce better upscaled results
- Avoid heavily compressed or artifacted source images
-
Format Selection: Choose output format based on use case
- PNG: Best for images with sharp edges, text, or transparency
- JPEG: Ideal for photographs and images with gradual color transitions
- WebP: Modern format with excellent compression for web use
-
Image Types: Optimal performance on:
- Photographs and realistic images
- Digital artwork and illustrations
- Screenshots and UI elements
- Scanned documents and historical images
-
Pre-processing: Consider basic cleanup before upscaling
- Remove obvious noise or artifacts if possible
- Ensure proper image orientation
- Crop to remove unnecessary borders or elements
-
Post-processing: Fine-tune results if needed
- Minor sharpening may enhance certain image types
- Color correction can improve overall appearance
- Consider format conversion for specific applications
Limitations & Considerations
Image Type Considerations
- Heavily Compressed Images: May show limited improvement
- Extremely Low Resolution: Very small images (under 64x64) may not upscale optimally
- Synthetic Images: AI-generated images may behave differently than natural photographs
- Text-Heavy Images: While supported, dedicated OCR tools may be better for text enhancement
Technical Limitations
- File Size: 50MB maximum input file size
- Processing Time: Larger images require longer processing times
- Batch Processing: Process images individually for best quality control
- Internet Dependency: Requires stable internet connection for processing
Notes
- Stable Image Upscaler uses advanced AI algorithms combining predictive and generative techniques
- Results may vary based on input image characteristics and quality
- The model is optimized for natural images but works well with various image types
- Processing times scale with input image size and complexity
- Output quality is generally superior to traditional interpolation methods