Credits

VIESUS Cloud credit model — per-image pricing, PDF formulas, subscription DPI limits, and upload retention.

VIESUS Cloud uses a credit system. Credits are consumed per enhancement based on the features applied. Unused credits in a billing period do not carry forward unless specified by your subscription plan.

---

Check remaining credits

query {
  credits {
    periodStart
    periodEnd
    usedCreditsThisPeriod
    remainingCreditsThisPeriod
  }
}

---

Image enhancement credits

When multiple features are active in a single enhancement, only the highest-cost feature is charged — credits do not add up.

Feature	Credits per image
Color Enhancement	1
Restoration	1
Background Handling	4
AI Upscaling	4

Examples

Features active	Charged
Color Enhancement only	1 credit
Color Enhancement + Restoration	1 credit (both cost 1; max is 1)
Color Enhancement + AI Upscaling	4 credits (max of 1 and 4)
Background Handling + AI Upscaling	4 credits (max of 4 and 4)
All features combined	4 credits

---

PDF enhancement credits

PDF credits are calculated from the analysis results. Run PDF analysis first — the metadata field reports estimated cost before you commit to an enhancement.

The analysis reports three numbers:

• Total — total embedded images in the PDF
• Enhancement — images eligible for color enhancement
• Resizing — images eligible for AI upscaling

Credit formulas:

Base cost     = Total ÷ 2 × 1
Resizing cost = Resizing × 3
Color cost    = Enhancement × 1

All features  = Base + Resizing + Color
No upscaling  = Base + Color
No color      = Base + Resizing

Example calculation

PDF with 40 total images, 31 eligible for color, 9 eligible for resizing:

Scenario	Calculation	Credits
All features	40÷2 + 31×1 + 9×3 = 20 + 31 + 27	78
No upscaling	20 + 31	51
No color enhancement	20 + 27	47

---

AI upscaling limits

Constraint	Value
Maximum input dimension	3,000 px (width or height)
Maximum enlargement ratio	4×
Maximum output dimension	11,996 px (width or height)

PDF output resolution limits by subscription:

Subscription	Maximum target resolution
Free	300 DPI
Basic	600 DPI
Business	1,200 DPI

---

Upload retention

Uploads are stored for 30 days by default, then automatically deleted. You are not charged for storage — this is a data management setting.

Change default retention for new uploads:

mutation {
  updateFileRetention(days: 7) {
    uploadRetentionDays
  }
}

This applies to uploads made after the change. Existing uploads keep their original 30-day retention.

Delete an upload immediately:

mutation {
  deleteUploads(ids: ["upload-id"]) {
    deletedUploadIds
  }
}

Multiple uploads can be deleted in one call by passing multiple IDs.

---

Managing costs

Review PDF credit estimate before enhancing — the analysis phase is free. Check metadata.totalCredits before calling createEnhancedImage.

Disable upscaling when not needed — set targetResolution to match the actual embedded image resolution to avoid triggering resizing credits.

One upload, multiple enhancements — the same upload can be enhanced multiple times without re-upload costs. Use this to test different parameter combinations cheaply.

Track usage by period — use the credits query to monitor consumption and avoid surprises at billing time.