Get started
Quickstart
From zero to a generated image in three steps. No SDK required — curl is enough. Drop in the Kiara SDK later for typed helpers and a built-in waitFor().
The example below is text-to-image, but the same endpoint also serves image-to-image models (face swap, edit, upscale — pass a source_image_url) and video models (pass duration_seconds and resolution). Switch by changing the product field — see the model reference for each model's required inputs.
Step 1
Get an API key
Sign up and your first kiara_live_ key is auto-minted on the welcome page. New accounts start with a zero balance — top up credits with crypto in Dashboard › Top up before your first live generation. Mint more keys in Dashboard › API keys. Keys are revealed once and never shown again.
Step 2
Submit a generation
POST a prompt and your bearer key. The response is the generation object with status: queued — you can poll it or wait for a webhook.
Passing Idempotency-Key makes retries safe — calling with the same key + body returns the original job without double-charging.
Step 3
Wait for the result
Poll the generation at /v1/generations/{id} until status becomes completed or failed. Median latency is ~60 s for Kiara Image Pro. Skip polling by setting a webhook URL on the create call.
What next