Ruwana Developer Documentation
Build a directed Ruwana PRO production.
PRO combines exactly one selected model identity with ordered visual references and structured photographic direction. Standard API clients can create a private Custom Model first and reuse its stable mdl_* ID.
| Contract | Rule |
|---|---|
POST /v1/pro/generate | Authenticated multipart production request |
| Identity | Exactly one: custom_model_id or separately entitled model_id |
| References | 1–9 ordered PNG/JPEG/WebP files with explicit roles/fidelity |
| Direction | Commercial objective, scene/action, styling, performance, light, composition and camera intent |
| Status | GET /v1/requests/{requestId} |
| Retention | Successful media delivered for 7 days |
Output tiers
| Resolution | Price | Formats |
|---|---|---|
| 1K | $0.15 | PNG |
| 2K | $0.17 | PNG + TIFF |
| 4K | $0.19 | PNG + TIFF + DNG |
Reference surcharge: $0. Legacy requested 4:5 is reported separately from the effective 3:4 rendered output aspect.
Create the identity first.
Use the authenticated Custom Models workflow to create, save and retrieve a stable mdl_... identity, then send it as custom_model_id.