Ruwana Developer Documentation

Implementation contracts for production AI.

Use the docs to move from product discovery to working code: authenticate once, give every logical production request an idempotency key, follow the product-specific input contract and archive successful media before its delivery window expires.

API fundamentals

Product implementation

Image API

Creative JSON/multipart, Product, Polish, aspect, count, references and multi-format delivery.

Image docs →

Motion API

Character image + motion video, server-derived duration, pricing and durable request status.

Motion docs →

Avatar API

Image + speech/audio, public voices, emotions, speech rate and asynchronous production.

Avatar docs →

Ruwana PRO API

Model identity, 1–9 ordered references, structured photographic direction and durable status.

PRO docs →

Ruwana Video API

I2V/T2V, Start/End, Bind, Multi-Shot, 1080p/4K, audio and durable status.

Video docs →

Custom Models API

Create a private identity, save mdl_... and reuse it as custom_model_id in PRO.

Custom Models docs →

Production integration

Production readiness

Documented file limits, idempotency, durable states, safe retries, billing behavior and media archival.

Open readiness guide →

Security & data

Verified organization-key and generated-media behavior, without unsupported compliance claims.

Open Security & data →

Looking for what the AI can do?

Capabilities explain production behavior and use-oriented inputs; Docs define the exact public implementation contract.