Skip to main content

Freepik API uses Magnific.ai technology, now available as a comprehensive API service.

Precision V2 delivers enhanced upscaling with fine-grained controls for sharpness, texture, and detail while preserving image fidelity.
Upscaler Precision V2 is an advanced image upscaling API that enhances resolution while intelligently adding details and improving image quality. Building on the original Precision upscaler, V2 introduces granular control over sharpness, grain texture, and ultra-fine detail enhancement. The API supports multiple image types through specialized processing flavors optimized for photos, illustrations, and noisy images. Looking for creative, prompt-guided upscaling? See Upscaler Creative.

​
Key capabilities

  • Scale factors 2x to 16x: Multiply image dimensions from 2x up to 16x (up to 256x total pixels)
  • Sharpen control: Adjustable sharpening intensity (0-100, default 7) for edge definition and clarity
  • Smart grain: Intelligent texture enhancement (0-100, default 7) to preserve natural film grain and prevent artificial smoothness
  • Ultra detail: Fine detail enhancement level (0-100, default 30) for textures, patterns, and micro-details
  • Processing flavors: Three optimized modes: sublime for illustrations, photo for photographs, photo_denoiser for noisy images
  • Async processing: Webhook notifications or polling for task completion
  • Flexible input: Accepts HTTPS URLs or base64-encoded images

​
Use cases

  • E-commerce: Upscale product photos with enhanced sharpness while preserving color accuracy and texture
  • Photography restoration: Enhance old photos with smart grain to maintain natural film characteristics
  • Print production: Scale digital images for large-format printing with ultra detail for crisp output
  • Illustration enhancement: Upscale digital art with the sublime flavor for smooth gradients and vibrant colors
  • Real estate: Enhance property photos with the photo flavor for realistic detail preservation
  • Archival digitization: Restore scanned documents and photos with noise reduction via photo_denoiser

​
Upscale images with Precision V2

Create an upscaling task by submitting a request to the API. The service returns a task ID for async polling or webhook notification.

POST /v1/ai/image-upscaler-precision-v2

Create a new image upscaling task

GET /v1/ai/image-upscaler-precision-v2

List all Precision V2 tasks

GET /v1/ai/image-upscaler-precision-v2/{task-id}

Get task status and results by ID

​
Parameters

ParameterTypeRequiredDefaultDescription
imagestringYes-Source image as HTTPS URL or base64-encoded string
scale_factorinteger or stringNo-Scaling multiplier: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, or 16
sharpenintegerNo7Sharpness intensity (0-100). Higher values increase edge definition
smart_grainintegerNo7Grain/texture enhancement (0-100). Preserves natural film grain
ultra_detailintegerNo30Fine detail level (0-100). Controls textures and micro-details
flavorstringNo-Processing mode: sublime, photo, or photo_denoiser
webhook_urlstringNo-URL for completion notification with task status and output URL

​
Frequently Asked Questions

Upscaler Precision V2 is an AI-powered image upscaling API that increases image resolution while intelligently enhancing details. You submit an image via URL or base64, receive a task ID, then poll for results or receive a webhook notification when processing completes. The API adds fine details based on the content type and your parameter settings.
Precision V2 introduces granular control parameters that V1 does not have: sharpen (edge definition), smart_grain (texture preservation), and ultra_detail (micro-detail enhancement). V2 also supports processing flavors optimized for different image types. Use V2 when you need fine-tuned control over the upscaling output.
The three flavors are: sublime for artistic and illustrated images with smooth gradients and vibrant colors; photo for photographic images preserving natural colors and realistic details; photo_denoiser for photos with noise reduction, ideal for low-light or grainy photographs. Choose based on your source image type.
Sharpen (default 7) controls edge clarity and definition. Smart grain (default 7) adds natural texture to prevent artificial smoothness. Ultra detail (default 30) enhances fine patterns and micro-details. All range from 0-100. Start with defaults and adjust based on your specific image needs.
Precision V2 supports scale factors from 2 to 16. A scale factor of 2 doubles dimensions (4x total pixels), while 16 increases dimensions 16-fold (256x total pixels). Higher scale factors increase processing time and output file size.
Rate limits vary by subscription tier. See the Rate Limits page for current limits by plan.
Pricing is based on output image area in pixels, determined by input dimensions and scale factor. See the Pricing page for current rates and subscription options.
Precision V2 focuses on faithful upscaling with controlled detail enhancement, preserving the original content while adding sharpness and texture. Creative uses prompts to introduce or infer new visual elements and stylization. Choose Precision V2 when fidelity matters; choose Creative when you want artistic enhancement.

​
Best practices

  • Input quality: Start from the highest-quality source available. Avoid heavily compressed images as artifacts may be amplified
  • Flavor selection: Use sublime for illustrations and digital art, photo for natural photographs, photo_denoiser for noisy or low-light images
  • Parameter tuning: Start with default values (sharpen: 7, smart_grain: 7, ultra_detail: 30) and adjust incrementally based on results
  • Scale factor: Begin with 2x-4x for most use cases. Higher factors (8x-16x) work best with high-quality source images
  • Grain for realism: Increase smart_grain for photographic images to avoid the “plastic” look common in AI upscaling
  • Production integration: Use webhooks instead of polling for scalable, event-driven applications
  • Error handling: Implement retry logic with exponential backoff for 503 errors during high traffic