Flashvsr Upscale Video

0.60 credits/megapixel
ae_flashvsr_upscale_video

Increase a video’s resolution and sharpness up to 4×, with color correction, output format, and audio-preservation options.

UpscalingVideo
0.60 credits/megapixel

Pricing

0.60 credits per megapixel of upscaled video data: output width × output height × frame count.

0.60 credits/megapixel

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYesNo parameter description.—
request_body.seedinteger | unknownNoThe random seed used for the generation process.—
request_body.qualityintegerNoQuality level for tile blending (0-100). Controls overlap between tiles to prevent grid artifacts. Higher values provide better quality with more overlap. Recommended: 70-85 for high-res videos, 50-70 for faster processing.70
request_body.color_fixbooleanNoColor correction enabled.true
request_body.sync_modebooleanNoIf `True`, the media will be returned inline and not stored in history.false
request_body.video_urlstringYesThe input video to be upscaled—
request_body.accelerationenum (regular | high | full)NoAcceleration mode for VAE decoding. Options: regular (best quality), high (balanced), full (fastest). More accerleation means longer duration videos can be processed too.regular
request_body.output_formatenum (X264 (.mp4) | VP9 (.webm) | PRORES4444 (.mov) | GIF (.gif))NoThe format of the output video.X264 (.mp4)
request_body.output_qualityenum (low | medium | high | maximum)NoThe quality of the output video.high
request_body.preserve_audiobooleanNoCopy the original audio tracks into the upscaled video using FFmpeg when possible.false
request_body.upscale_factornumberNoUpscaling factor to be used.2
request_body.output_write_modeenum (fast | balanced | small)NoThe write mode of the output video.balanced

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key

Submit first, then query with the returned task_id until the task completes.

Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_flashvsr_upscale_video' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "acceleration": "regular",
      "color_fix": true,
      "output_format": "X264 (.mp4)",
      "output_quality": "maximum",
      "quality": 80,
      "upscale_factor": 2,
      "video_url": "https://v3b.fal.media/files/b/0ab2d975/KAYaIy0UTnVGW5QMIzlXT_6fed64b916bd403095ea229a771ee26a.mp4"
    }
  }
}'
Response exampleresponse.json
JSON
{
  "description": "task accepted; poll the result via query_tool with this task_id",
  "query_tool": "ae_get_result",
  "status": "created",
  "task_id": "fe0eeda4-f415-4e3a-a687-b41ab7de6806"
}