# Flux Vision Upscaler

Enhance and upscale your visuals with cinematic clarity using Flux Vision Upscaler.

## API Information

- **Model Slug:** flux-vision-upscaler
- **Branded URL:** https://www.eachlabs.ai/black-forest-labs/flux/flux-vision-upscaler
- **Provider:** Black Forest Labs
- **Category:** Image to Image
- **Output Type:** image
- **Status:** active
- **Version:** 0.0.1
- **Base Cost:** Per-megapixel pricing: $0.1/MP (ceil rounding)
- **Estimated Processing Time:** 420 seconds
- **Last Updated:** 2026-06-29
- **Interactive Demo:** https://www.eachlabs.ai/ai-models/flux-vision-upscaler

## Pricing

- **Charge Type:** dynamic
- **Pricing Details:** Per-megapixel pricing: $0.1/MP (ceil rounding)

### Pricing Rules

| Condition | Pricing |
| --- | --- |
| Rule 1 | Per-megapixel pricing: $0.1/MP (ceil rounding) |

## Input Schema

| Parameter | Type | Required | Default | Constraints | Description |
|-----------|------|----------|---------|-------------|-------------|
| image_url | string | Yes | - | - | The URL of the image to upscale. |
| upscale_factor | number | No | 2 | 1–4 | The upscale factor (1-4x). |
| seed | string | No | - | - | The seed to use for the upscale. If not provided, a random seed will be used. |
| creativity | number | No | 0.3 | 0–1 | The creativity of the model. The higher the creativity, the more the model will deviate from the original. Refers to the denoise strength of the sampling. |
| guidance | number | No | 1 | 0–20 | CFG/guidance scale (0-20). Controls how closely the model follows the guidance. |
| steps | integer | No | 20 | 4–50 | Number of inference steps (4-50). |
| enable_safety_checker | boolean | No | true | - | Whether to enable the safety checker. |

## Example Request

```bash
curl -X POST https://api.eachlabs.ai/v1/prediction/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "flux-vision-upscaler",
  "input": {
    "image_url": "https://storage.googleapis.com/magicpoint/inputs/flux-vision-upscaler-input.png"
  }
}'
```

## Output Schema

Response returned by `GET /v1/prediction/{id}` when the job completes:

```json
{
  "status": "success",
  "predictionID": "string",
  "output": "string (URL of generated image)",
  "metrics": {
    "predict_time": "number (seconds)"
  }
}
```

## Polling

```bash
curl https://api.eachlabs.ai/v1/prediction/{PREDICTION_ID} \
  -H "Authorization: Bearer YOUR_API_KEY"
```

| Status | Meaning |
|--------|---------|
| `processing` | Still running — poll again |
| `success` | Done — read `output` |
| `error` | Failed — read `message` / `details` |

## Webhook (alternative to polling)

Pass `"webhook_url": "https://your.host/path"` in the create request. Eachlabs POSTs this payload when the job ends:

```json
{
  "exec_id": "prediction-uuid",
  "status": "succeeded",
  "output": "https://...",
  "error": ""
}
```

`status` is `"succeeded"` or `"failed"`. `exec_id` equals the `predictionID` from create. Return 2xx within 30 seconds.

## Errors

Error body: `{ "status": "error", "message": "...", "details": "..." }`

| Code | Meaning |
|------|---------|
| `400` | Invalid input |
| `401` | Missing / invalid `Authorization` bearer token |
| `404` | Unknown model or prediction id |
| `429` | Rate limit — 100 creates / min, 10 concurrent per key |
| `5xx` | Retry with backoff |

## Overview

Flux Vision Upscaler is an advanced AI-powered image upscaling model designed to enhance and magnify visuals with high fidelity and cinematic clarity. While the original developer is not explicitly named in the available search results, the model is widely recognized in the AI image generation community for its ability to upscale images while preserving or even inventing fine details, textures, and sharp edges. It is part of a broader family of Flux models, which are known for balancing speed, cost, and output quality, and are often used in professional and creative workflows.

The model leverages neural network architectures trained on massive datasets, enabling it to infer and reconstruct missing or degraded image information far beyond the capabilities of traditional interpolation methods. What sets Flux Vision Upscaler apart is its support for high scaling factors (up to 8x or more, depending on the specific variant), optional integration with LoRA (Low-Rank Adaptation) models for style and character consistency, and the ability to use reference style images to guide the upscaling process. This makes it particularly valuable for users who need not just larger images, but images with enhanced, believable detail and artistic control.

## Usage Notes

- API Base URL: `https://api.eachlabs.ai/v1`
- Authentication: send `Authorization: Bearer YOUR_API_KEY`. Generate a key from the Eachlabs dashboard at https://www.eachlabs.ai/dashboard/api-keys.
- File-typed parameters (`*_url`, `image_url`, `video_url`, `audio_url`, etc.) accept publicly-reachable HTTPS URLs only. Upload your asset first (GCS / S3 / your CDN) and pass the resulting URL. Data-URIs and localhost URLs are rejected.
- For structured parameters (arrays / objects) send real JSON values, not stringified payloads.
- Monetary values are reported in USD; per-token / per-megapixel rates may be billed in micro-cents internally.
- Prefer `webhook_url` over polling for long-running predictions — see the Webhook Callback section.