Developers
NiniOne API
Make images and talking-avatar videos from your own software. The API comes with the Enterprise package: every request spends tokens from your NiniOne balance.
1. Get a key
Create an account, buy the Enterprise package on Plan & tokens, then create a key on the API page. The key is shown once. Send it with every request:
Authorization: Bearer nk_live_…
Use the base address https://www.ninione.app exactly, with www: the bare domain redirects there, and most HTTP clients drop the Authorization header when they follow a redirect to another host.
Treat it like a password: keep it on your server, never in a web page or a mobile app. If it leaks, revoke it on the API page and create a new one.
2. Make an image
POST https://www.ninione.app/api/v1/images
Content-Type: application/json
{
"prompt": "Steaming khinkali on a wooden table, evening light",
"quality": "base", // "base" (default) or "premium"
"format": "1:1" // "1:1" (default), "9:16" or "16:9"
}
202 Accepted
{ "id": "6f1c…", "object": "job", "type": "image", "status": "queued", "tokens": 3 }The prompt can be in any language. Base picks the model that fits the prompt best; Premium uses our best image model and is the one to choose for text on the image in Georgian or Russian. Prompt: up to 2000 characters.
3. Make an avatar video
POST https://www.ninione.app/api/v1/avatar-videos
Content-Type: application/json
{
"script": "Welcome to Khinkali House! Fresh khinkali every day from noon.",
"presenter": "a friendly woman in her thirties wearing an apron", // optional
"photo_url": "https://example.com/face.jpg" // optional
}
202 Accepted
{ "id": "a91d…", "object": "job", "type": "avatar_video", "status": "queued", "tokens": 4 }The script is spoken word for word (3 to 1000 characters), in the language it is written in. With photo_urlthe presenter has that face: it must be a public https address, and you must have the right to use the person's image. A video takes a few minutes and runs in steps (voice, video, edit); each step is charged when it starts, and the job shows the total.
4. Get the result
GET https://www.ninione.app/api/v1/jobs/{id}
200 OK
{
"id": "6f1c…",
"object": "job",
"status": "completed", // queued | processing | completed | failed
"output_url": "https://…", // when completed
"output_type": "image", // image | video
"tokens": 3, // everything this job has cost so far
"error": null, // a message when failed
"created_at": "2026-11-09T10:00:00Z"
}Poll every 3 to 5 seconds for images and every 10 to 15 seconds for videos. Download the file when it is ready: links to results are not guaranteed to last forever. Everything you make also appears in My files in the app. If a job fails before the provider starts it, its tokens are given back automatically.
5. Balance and prices
GET https://www.ninione.app/api/v1/balance
{ "object": "balance", "tokens_available": 420, "token_value_usd": 0.1, ... }
GET https://www.ninione.app/api/v1/prices (no key needed)| Product | Tokens | Notes |
|---|---|---|
| image.base | 1 | One image. The model is chosen for the prompt, so the price depends on it. |
| image.premium | 1 | One image at the best quality, including words in Georgian or Russian. |
| avatar_video.8s | 15 | A talking presenter, about 8 seconds of speech (voice, video and edit). |
| avatar_video.15s | 26 | A talking presenter, about 15 seconds of speech. |
The same tokens as the same thing made in the app. A token costs ₾0.50, down to ₾0.35 on larger top-ups; there is no subscription.
6. Errors and limits
{ "error": { "code": "insufficient_tokens", "message": "Not enough tokens. Top up at …" } }| Status | code | Meaning |
|---|---|---|
| 400 | invalid_request / invalid_json | A field is missing or wrong; the message says which. |
| 401 | unauthorized | Missing, wrong or revoked key. |
| 402 | insufficient_tokens | Top up, then retry. |
| 403 | enterprise_required | The account has no Enterprise package yet. |
| 404 | not_found | No such job on this account. |
| 429 | rate_limited | Wait the seconds in the Retry-After header. |
| 503 | unavailable | Temporary. Retry in a minute. |
Limits per key, per minute: 30 images, 10 avatar videos, 120 status checks. Need more? Write to support@ninione.app.
Acceptable use
The acceptable use policy applies to the API exactly as to the app. No content that imitates a real person without their consent.