Overview

VIESUS Cloud is a managed GraphQL API for image and PDF enhancement. No infrastructure required — upload, enhance, retrieve.

VIESUS Cloud is a fully managed API that gives you access to the complete VIESUS enhancement engine without installing or operating any infrastructure. Upload images or PDFs, trigger enhancements, and retrieve results — pay only for what you process.

---

Engine version

VIESUS Cloud currently runs VIESUS 12.

This version applies to the managed enhancement engine behind the Cloud API and Webapp. Platform updates are rolled out on the server side, so you do not install or upgrade the engine yourself.

---

API endpoint

All requests go to a single GraphQL endpoint:

https://api.viesus.cloud/graphql

Requests are standard HTTP POST with a JSON body. Any GraphQL client library or plain fetch/curl works.

Language	Recommended library
Node.js	graphql-request
Python	gql
PHP	webonyx/graphql-php
Go	hasura/go-graphql-client

GraphQL Playground

Explore the full schema and run queries interactively: https://api.viesus.cloud/graphiql

Add your x-api-key header and run any mutation or query directly from the browser. The schema browser shows all available enum values and input types.

---

How it works

Every integration follows five steps:

1. Authenticate  →  x-api-key header on every request
2. Upload        →  from URL or via signed upload URL
3. Enhance       →  createEnhancedImage mutation
4. Poll / webhook →  check status or receive push notification
5. Retrieve      →  download from fullUrl

The same upload can be enhanced multiple times with different parameters — useful for A/B testing configurations or generating multiple output variants.

---

Supported file types

Format	MIME type	Notes
JPEG	image/jpeg
PNG	image/png
TIFF	image/tiff
HEIC	image/heic	Currently converted to JPEG after processing — this will change in a future version
WebP	image/webp	Currently converted to JPEG after processing — this will change in a future version
PDF	application/pdf	Requires analysis phase before enhancement

File size limits:

Type	Minimum	Maximum
Images	20 KB	50 MB
PDF files	20 KB	1,000 MB

---

Use cases

Scenario	Approach
SaaS product — enhance on upload	Signed upload URL → webhook on completion
Batch from existing CDN	Upload from URL in a loop → poll or webhook
PDF print workflow	Upload PDF → wait for analysis → enhance
A/B test enhancement settings	One upload → multiple createEnhancedImage calls
One-off manual enhancement	Dashboard UI (no API required)

---

Quick example

# 1. Upload from URL
UPLOAD_ID=$(curl -s -X POST https://api.viesus.cloud/graphql \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR-API-KEY" \
  -d '{"query":"mutation { createUploadFromUrl(input: { url: \"https://example.com/photo.jpg\" }) { id } }"}' \
  | jq -r '.data.createUploadFromUrl.id')

# 2. Enhance
ENHANCEMENT_ID=$(curl -s -X POST https://api.viesus.cloud/graphql \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR-API-KEY" \
  -d "{\"query\":\"mutation { createEnhancedImage(uploadId: \\\"$UPLOAD_ID\\\", input: { mode: ENHANCE }) { id status } }\"}" \
  | jq -r '.data.createEnhancedImage.id')

# 3. Check status
curl -s -X POST https://api.viesus.cloud/graphql \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR-API-KEY" \
  -d "{\"query\":\"query { enhancedImage(id: \\\"$ENHANCEMENT_ID\\\") { status fullUrl } }\"}"