Cloud API

VIESUS Cloud GraphQL API reference — authentication, uploading, image and PDF enhancement, credits, and webhooks.

The VIESUS Cloud API is a hosted GraphQL service for image and PDF enhancement. No server to manage, no GUID to bind, no GPU to procure — upload, enhance, download. Billed per image via a credit system, with a free tier for evaluation.

Use the Cloud API when you don't want to operate your own infrastructure, when you need on-demand AI upscaling without a local GPU, or to add VIESUS to a frontend that already calls other cloud APIs.

Overview

What the Cloud API offers, when to use it vs on-premise, and the GraphQL endpoint.

Authentication

API keys, header conventions, and how to manage authentication for production.

Uploading

Multipart upload, file size limits, supported formats, and signed URLs.

Enhance Images

The image enhancement mutation: parameters, options, response shape, async behavior.

Enhance PDFs

PDF enhancement endpoint, page selection, and result retrieval.

Credits

How credits are consumed, free tier limits, and how to top up.

Webhooks

Async notification on enhancement completion — payload format, retries, and signing.