Skip to main content

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

FieldValue
API-KEY<api-key>
Content-Typeapplication/json

Parameters

ParameterTypeRequiredDescription
typestringYesFeature type identifier. Must be IMAGE_UPSCALER
modelstringYesAI model identifier. Must be stable-image
promptObjectobjectYesConfiguration object containing all upscaling parameters

Prompt Object Parameters

ParameterTypeRequiredDescriptionDefault
imageUrlstringYesPath to the image to be upscaled-
output_formatstringNoOutput format for the upscaled imagepng

Supported Output Formats

FormatDescriptionBest For
pngHigh quality, lossless compressionDetailed images, graphics with transparency
jpegSmaller file size, slight compressionPhotographs, web images
webpModern format, excellent compressionWeb applications, modern browsers

Code Examples

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"
}
}'

Interactive Playground

API Playground

https://api.1min.ai/api/features
Path 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

  1. Input Quality: Start with the highest quality source image available

    • Higher quality inputs produce better upscaled results
    • Avoid heavily compressed or artifacted source images
  2. 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
  3. Image Types: Optimal performance on:

    • Photographs and realistic images
    • Digital artwork and illustrations
    • Screenshots and UI elements
    • Scanned documents and historical images
  4. 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
  5. 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