NiniOneNiniOne← Back to home

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)
ProductTokensNotes
image.base1One image. The model is chosen for the prompt, so the price depends on it.
image.premium1One image at the best quality, including words in Georgian or Russian.
avatar_video.8s15A talking presenter, about 8 seconds of speech (voice, video and edit).
avatar_video.15s26A 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 …" } }
StatuscodeMeaning
400invalid_request / invalid_jsonA field is missing or wrong; the message says which.
401unauthorizedMissing, wrong or revoked key.
402insufficient_tokensTop up, then retry.
403enterprise_requiredThe account has no Enterprise package yet.
404not_foundNo such job on this account.
429rate_limitedWait the seconds in the Retry-After header.
503unavailableTemporary. 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.

© 2026 NiniOne
TermsPrivacyContact