Yapper API
Models & Inputs

Upscales

Image and video upscale models and their inputs.

image-upscale

POST /api/v1/processes with "type": "image-upscale". Pick any model — the API does not plan-gate models. GET /api/v1/models returns the same capabilities at runtime.

Input fields

FieldTypeRequiredDescription
disableAutoRetriesbooleannoDisable automatic same-model retries. Defaults to false, so automatic retries are enabled.
upscaleFactornumbernoUpscale multiplier, e.g. 2.
imageAssetDocIdstringnoAsset id of the image to process (from /assets). Required unless imageUrl is provided.
imageUrlstringnoPublic image URL — imported into your asset library automatically, then upscaled. Alternative to imageAssetDocId.

Example

Add "dryRun": true to get the exact credit cost without starting, and always send an Idempotency-Key header on real starts.

POST /api/v1/processes
{
  "type": "image-upscale",
  "model": "topaz-image-upscale",
  "input": {
    "imageUrl": "https://example.com/photo.jpg"
  }
}

Models

Cost depends on the input — use dryRun: true for an exact quote.

ModelNameDescription
topaz-image-upscaleTopaz Standard V2Fast, faithful enlargement for already-decent photos. Preserves the source with less reconstruction of damaged detail.
topaz-wonder-3.5-image-upscaleTopaz Wonder 3.5Best overall quality for low-resolution or compressed photos. Rebuilds realistic detail; slower and may reinterpret tiny details.
topaz-bloom-2-image-upscaleTopaz Bloom 2Best for AI-generated images. Adds realistic skin, hair, fabric, and texture; most creative and most expensive.
topaz-recover-3-image-upscaleTopaz Recover 3Best for old, tiny, blurry, or damaged photos—especially faces. Reconstructs missing detail; unnecessary for clean sources.

video-upscale

POST /api/v1/processes with "type": "video-upscale". Pick any model — the API does not plan-gate models. GET /api/v1/models returns the same capabilities at runtime.

Input fields

FieldTypeRequiredDescription
promptstringnoWhat to generate.
disableAutoRetriesbooleannoDisable automatic same-model retries. Defaults to false, so automatic retries are enabled.
upscaleFactornumbernoUpscale multiplier, e.g. 2.
videoAssetIdstringnoAsset id of the video to process (from /assets). Required unless videoUrl is provided.
videoUrlstringnoPublic video URL — imported into your asset library automatically, then upscaled. Alternative to videoAssetId.

Example

Add "dryRun": true to get the exact credit cost without starting, and always send an Idempotency-Key header on real starts.

POST /api/v1/processes
{
  "type": "video-upscale",
  "model": "flow-upscaling",
  "input": {
    "videoUrl": "https://example.com/clip.mp4"
  }
}

Models

Cost depends on the input — use dryRun: true for an exact quote.

ModelNameDescription
flow-upscalingHD UpscalingUpscale your video to 1080p or 4k.
mmaudio-2AI AudioAdd AI-generated audio to your video
topaz-video-upscaleProteus NaturalBest for a clean, affordable 2x. Preserves the source while reducing compression, halos, and jagged edges.
topaz-rhea-upscaleRhea 4xBest-value 4x for stable footage with solid structure. Recovers fine detail in AI video, interviews, products, and textures.
topaz-starlight-precise-2.6Starlight 2.6Best quality for AI video. Improves soft or plastic-looking faces, skin, textures, and flicker; slowest and most expensive.
flux-video-upscaleFLUX CreativeCreative FLUX 3 super-resolution for generated footage. Rebuilds fine detail aggressively for the sharpest result; faces and products may drift.
flux-video-upscale-preciseFLUX PreciseSource-faithful FLUX 3 super-resolution for faces, products, text, and brand assets. Sharpens and removes noise without creatively changing details.

On this page