Portrait is the identity anchor
The portrait establishes the canonical saved identity. The full-body image is the derived casting/library view used to inspect the model as a complete figure.
Ruwana Custom Models · API live
Create your own private model identity through API.
Ruwana Platform clients can create a private adult synthetic model identity, derive its full-body casting view, save the identity once and reuse its stable mdl_... ID in later Ruwana PRO productions. You are not limited to choosing a model from the Ruwana roster.
Private to your organizationStable mdl_* IDReusable in PROAPI-created identity
The complete API workflow
Identity creation is a short stateful workflow. Save is the step that turns an approved candidate into a reusable private production identity.
1. Generate portrait
POST /v1/models/generate creates the canonical portrait candidate from your adult synthetic casting direction.
2. Derive full body
POST /v1/models/full-body uses the portrait identity anchor to produce the full-body casting/library view.
3. Save the model
POST /v1/models/save returns a stable private mdl_... model ID. Saving itself has no generation charge.
4. Direct it in PRO
Send the saved ID as custom_model_id in POST /v1/pro/generate. The same identity can return across later productions.
Model library operations
POST /v1/models/generate
POST /v1/models/full-body
POST /v1/models/save
GET /v1/models
DELETE /v1/models/{model_id}
POST /v1/pro/generate
custom_model_id = mdl_...Private and persistent
A saved Custom Model belongs to the owning Platform organization and remains reusable until it is explicitly deleted.
Separate from roster access
Private custom_model_id is the standard customer-created identity path. Ruwana roster model_id is a separate licensed/entitled identity source.
Creation pricing
| Step | Price | Result |
|---|---|---|
| Portrait candidate | $0.12 | Canonical portrait candidate |
| Full-body view | $0.15 | Derived casting/library view |
| Save | $0.00 | Stable mdl_... identity |
Ruwana PRO generation is billed separately by its published 1K/2K/4K output tier.
From casting to a directed photograph.
Create the identity once, then use custom_model_id alongside explicit product/reference roles and photographic direction in PRO.