API reference / Generations

Retrieve generation

GET/v1/generations/{id}

Look up a generation by id. Poll this while a job is in flight, or call it from your webhook handler to confirm the payload you received.

Path parameters

Parameters

idstringRequired

The prefixed generation id (e.g. gen_01HV6ZNB...) returned by POST /v1/generations.

Behavior

Polling

Latency varies by model — see each model's page for its average (Kiara Image Pro lands in ~60 s; the fastest image models in ~10–12 s; video runs longer). We recommend polling at 2 s intervals with exponential backoff after the first minute. Skip polling entirely by setting webhook_url on create.

Request

GETRetrieve generation/v1/generations/{id}

curl https://api.kiara-api.com/v1/generations/gen_01HV6ZNB... \
  -H "Authorization: Bearer $KIARA_API_KEY"

Response

{
  0: 1,
  2: 3,
  4: 5,
  6: 7,
  8: {
    9: 10,
    11: 12,
    13: 14,
    15: 1536,
    16: 2560
  },
  17: {
    18: 19
  }
}