API Pricing

Pay as you go for successful production output.

Ruwana Platform uses a USD wallet for API consumption. Image and PRO bill per successful output; Video, Motion and Avatar bill by successful production duration.

USD walletSuccess-only production billingIdempotent replay7-day media delivery

Image API

Image pricing is per successful output. Request count supports 1–4 outputs.

Product1K2K4KNotes
LAB Creative$0.12$0.14$0.16+ $0.03/output when visual references are supplied
LAB Product$0.15$0.17$0.19Exactly one product reference required
LAB Polish$0.15$0.17$0.19Exactly one source image required

Delivery by resolution: 1K PNG; 2K PNG + TIFF; 4K PNG + TIFF + DNG derivative. Included delivery formats do not add an export surcharge.

Ruwana PRO API

PRO pricing is per successful photographic output. Visual references do not add a surcharge.

ResolutionPriceEndpoint
1K$0.15/v1/pro/generate
2K$0.17/v1/pro/generate
4K$0.19/v1/pro/generate

Video API

Video pricing is per successful second. Public delivery tiers are 1080p and 4K; Platform does not expose a 720p Video tier.

Mode1080p4KAudioEndpoint
Image-to-video$0.22/sec$0.30/sec+$0.08/sec native audio/v1/video/generate
Text-to-video$0.28/sec$0.34/secIncluded/v1/video/generate

Motion API

Motion uses the actual uploaded motion-video duration derived by the server, constrained to 3–30 seconds.

ResolutionRateBilling unitEndpoint
720p$0.18per second/v1/motion/generate
1080p$0.22per second/v1/motion/generate

Avatar API

Avatar uses prepared audio duration derived by the server. TTS is included when speech text is used.

TierResolutionRateTTSEndpoint
Standard720p$0.11/secIncluded/v1/avatar/generate
Pro1080p$0.22/secIncluded/v1/avatar/generate

Concrete cost examples

Examples use the current public rate card. Video, Motion and Avatar final billing follows the effective production duration defined by each public contract.

Four 1K Creative outputs

$0.48

Prompt-only: 4 × $0.12. With visual references: 4 × $0.15 = $0.60.

10-second Motion

$1.80 / $2.20

720p: 10 × $0.18. 1080p: 10 × $0.22.

10-second Avatar

$1.10 / $2.20

Standard 720p: 10 × $0.11. Pro 1080p: 10 × $0.22. TTS is included when speech text is used.

How API billing behaves

The wallet and request registry are designed to prevent a successful request from being charged again just because a client retries or polls status.

Before production

  • Organization and API key are resolved server-side
  • Idempotency protects the same logical request from duplicate execution
  • Media duration is derived server-side for Motion and Avatar
  • Available wallet balance is checked against the request quote

After production

  • Successful production creates one wallet debit
  • Ledger and usage records preserve the billed amount
  • Replaying the same successful Idempotency-Key returns the existing request
  • Generated media is retained for a fixed 7-day delivery window

Fund the wallet, then call any live API.

The same Platform organization and balance are shared across Image, PRO, Video, Motion and Avatar production.