API Reference
Complete reference documentation for the VIUCraft API including authentication, endpoints, error codes, and more.
Articles
Tenancy & URL Bases
Every VIUCraft request uses your tenant subdomain. How paid and free-tier URL bases work, and how to discover your own.
Upload Response Reference
Field-by-field reference for the upload 201 response: image_id is the permanent handle, filename is not, plus the duplicate (200) variant.
Delivery & Transform URL Grammar
The complete delivery/transform URL grammar: mandatory extension, subdomain and free-tier shapes, long vs short operation forms, and worked examples.
API Endpoint Map
The base-path split: upload and delivery at the root, management under /api/, CLI under /api/v1/cli/, agents at /mcp.
Rate Limits & Retries
Rate-limit headers, the 429 response body, Retry-After semantics, and how the SDK retries automatically.
Batch Jobs & Webhooks
Asynchronous batch processing with live SSE progress, and webhook subscriptions for image and batch events.
API Versioning & Deprecation Policy
How the API is versioned (dated 2025-01), what counts as a breaking change, and the deprecation timeline.