FLUX Video Upscale

​

Example output

​

Quick start

# Submit a clip by URL (or send a base64-encoded mp4 in input_video instead)
curl -sS -X POST "https://api.bfl.ai/v1/flux-tools/video-upscale-v1" \
  -H "Content-Type: application/json" \
  -H "x-key: $BFL_API_KEY" \
  -d '{
    "input_video": "https://your-storage.example.com/source-clip.mp4",
    "upscale_factor": 2.0,
    "creativity": 1
  }'

# Poll the polling_url from the response until status is "Ready"
curl -sS "https://api.bfl.ai/v1/get_result?id=YOUR_TASK_ID" \
  -H "x-key: $BFL_API_KEY"

import os, time, requests

BFL_API_KEY = os.environ["BFL_API_KEY"]

# 1. Submit — returns an id and a polling_url
submit = requests.post(
    "https://api.bfl.ai/v1/flux-tools/video-upscale-v1",
    headers={"x-key": BFL_API_KEY, "Content-Type": "application/json"},
    json={
        "input_video": "https://your-storage.example.com/source-clip.mp4",
        "upscale_factor": 2.0,
        "creativity": 1,
    },
).json()

# 2. Poll the returned URL until the job is Ready
while True:
    time.sleep(5)
    result = requests.get(submit["polling_url"], headers={"x-key": BFL_API_KEY}).json()
    if result["status"] == "Ready":
        print(result["result"]["sample"])   # signed .mp4 URL
        break
    if result["status"] in ("Error", "Request Moderated", "Content Moderated"):
        raise RuntimeError(result["status"])

{
  "id": "8b6a4d16-2b52-4a5e-9f1c-3e7d0a92c48b",
  "polling_url": "https://api.bfl.ai/v1/get_result?id=8b6a4d16-2b52-4a5e-9f1c-3e7d0a92c48b"
}

{
  "id": "8b6a4d16-2b52-4a5e-9f1c-3e7d0a92c48b",
  "status": "Ready",
  "result": {
    "sample": "https://delivery.bfl.ai/results/8b6a4d16-2b52-4a5e-9f1c-3e7d0a92c48b/sample.mp4?se=..."
  }
}

​

Choosing a mode

• creativity: 0 (precise) preserves the source exactly and sharpens it. Use it when identity matters: faces, products, brand assets, footage of real people.
• creativity: 1 (creative) restores and invents fine detail more aggressively. Use it on generated footage, textures, crowds, and scenery. It does not preserve identity as strictly as precise mode, so faces and products can drift.

​

Request parameters

​

Pricing

​

Tips for best results

• Start from the least compressed source you have. Compression artifacts limit how much real detail the upscaler can recover.
• Use creative mode for generated footage, landscapes, textures, and crowds; use precise mode when faces, products, or brand assets must stay exactly as they are.
• A short prompt describing the clip’s content can steer creative mode toward the right kind of detail.
• Run upscaling as your final step, after editing and trimming, so you only pay for footage you keep.

​

Limitations

• Source clips are limited to 20 seconds and 50MB.
• Output frames are capped at about 14.4 megapixels: requesting 3x on a source that is already high resolution lands below the requested factor.
• Creative mode does not strictly preserve identity for faces and products. Use precise mode when that matters.

​

Troubleshooting

• 403 Forbidden - your API key is missing or your project does not have access to this endpoint.
• 402 Payment Required - your credit balance cannot cover the request. Top up and retry.
• 422 / validation errors - check base64 encoding, video URL accessibility, the 50MB payload limit, and that upscale_factor is between 1.5 and 3.
• Status Error mentioning input length - the source clip is longer than 20 seconds. Trim it and resubmit; rejected clips are not charged.
• Status Error mentioning output size - the requested output exceeds what the endpoint can serve. Reduce upscale_factor or the source resolution.
• Faces or products look different - switch to creativity: 0 for a source-faithful upscale.