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.
Color Enhancement
1
Restoration
1
Background Handling
4
AI Upscaling
4
Examples
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:
Example calculation
PDF with 40 total images, 31 eligible for color, 9 eligible for resizing:
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
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:
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:
This applies to uploads made after the change. Existing uploads keep their original 30-day retention.
Delete an upload immediately:
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.
Last updated
Was this helpful?
