Documentation Index
Fetch the complete documentation index at: https://docs.freepik.com/llms.txt
Use this file to discover all available pages before exploring further.
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.
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:
sublimefor illustrations,photofor photographs,photo_denoiserfor 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
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
image | string | Yes | - | Source image as HTTPS URL or base64-encoded string |
scale_factor | integer or string | No | - | Scaling multiplier: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, or 16 |
sharpen | integer | No | 7 | Sharpness intensity (0-100). Higher values increase edge definition |
smart_grain | integer | No | 7 | Grain/texture enhancement (0-100). Preserves natural film grain |
ultra_detail | integer | No | 30 | Fine detail level (0-100). Controls textures and micro-details |
flavor | string | No | - | Processing mode: sublime, photo, or photo_denoiser |
webhook_url | string | No | - | URL for completion notification with task status and output URL |
Frequently Asked Questions
What is Upscaler Precision V2 and how does it work?
What is Upscaler Precision V2 and how does it work?
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.
What is the difference between Precision V2 and Precision V1?
What is the difference between Precision V2 and Precision V1?
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.
What are the processing flavors and when should I use each?
What are the processing flavors and when should I use each?
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.
How do sharpen, smart_grain, and ultra_detail affect results?
How do sharpen, smart_grain, and ultra_detail affect results?
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.
What scale factors are supported?
What scale factors are supported?
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.
What are the rate limits for Upscaler Precision V2?
What are the rate limits for Upscaler Precision V2?
Rate limits vary by subscription tier. See the Rate Limits page for current limits by plan.
How much does Upscaler Precision V2 cost?
How much does Upscaler Precision V2 cost?
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.
What is the difference between Precision V2 and Upscaler Creative?
What is the difference between Precision V2 and Upscaler Creative?
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
sublimefor illustrations and digital art,photofor natural photographs,photo_denoiserfor 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
Related APIs
- Upscaler Creative: Prompt-guided upscaling with creative detail generation and stylization
- Upscaler Precision: Original precision upscaler without V2’s granular controls