RuwanaRuwanaPlatform API
Ruwana API / AI Image API
AI Image API

Commercial image generation with distinct creative, product and polish workflows.

Use one organization key to generate new visuals, build product-focused output or refine an existing image. Delivery tiers scale from 1K PNG to 4K multi-format results.

Full Image docsView image pricing
1K · 2K · 4KPNGTIFF from 2KDNG derivative at 4K1–4 outputs

Three live image endpoints

Each mode has a separate production contract so an application can ask for the right kind of work instead of treating every image request the same.

LAB Creative

Generate new commercial compositions from a prompt, optionally guided by 1–16 visual references.

POST /v1/lab/creative
$0.12+
1K base · references add $0.03 per output

LAB Product

Product-focused generation from exactly one supplied image reference, with controlled commercial output.

POST /v1/lab/product
$0.15+
Exactly one product reference required

LAB Polish

Refine an existing visual while preserving the supplied subject and composition intent.

POST /v1/lab/polish
$0.15+
Exactly one source image required

Resolution and delivery formats

The requested resolution controls both the price and the file formats delivered with a successful result.

Mode1K2K4KDelivery
LAB Creative$0.12$0.14$0.161K PNG · 2K PNG + TIFF · 4K PNG + TIFF + DNG
LAB Product$0.15$0.17$0.191K PNG · 2K PNG + TIFF · 4K PNG + TIFF + DNG
LAB Polish$0.15$0.17$0.191K PNG · 2K PNG + TIFF · 4K PNG + TIFF + DNG

Creative requests with one or more references add $0.03 per output. TIFF and DNG delivery derivatives are included in the listed resolution price.

Reference-aware requests

Reference media is uploaded as multipart form data. Ruwana validates file type and count before production execution.

Creative references

  • 0 references for text-driven generation
  • 1–16 PNG, JPEG or WebP references when visual guidance is needed
  • Reference order participates in request identity
  • Reference-guided Creative adds one fixed $0.03 modifier per output

Product and Polish

  • Exactly one image reference is required
  • Uploaded media is bounded and validated before execution
  • Count supports 1–4 outputs
  • Idempotent replay does not generate or bill the same successful request again

Example: Creative with references

Use multipart form data whenever references are present.

curl https://platform.ruwana.studio/v1/lab/creative \
  -H "Authorization: Bearer $RUWANA_API_KEY" \
  -H "Idempotency-Key: campaign-001" \
  -F "prompt=Create a clean luxury product composition" \
  -F "resolution=2K" \
  -F "count=1" \
  -F "references[]=@reference.jpg"

Understand the production capability

Build image production into your own workflow.

Start with Creative, Product or Polish and use the same Platform wallet, API key and delivery contract across all three.

Open QuickstartOpen Platform