Four endpoints cover the entire API surface. Each one has a dedicated page with full request shape, response schema, code samples, and the errors it can return.
/api/v1/generateSubmit a generation job. Returns a generation_id you can poll.
/api/v1/generations/{id}Check whether a generation has completed and read the output URL.
/api/v1/modelsList the models available to your key, including param schemas and cost bands.
/api/v1/creditsRead your current credit balance, tier, and cycle reset date.
Across every endpoint:
https://getvivix.comAuthorization: Bearer vvx_live_… on every requestapplication/json for all POSTsgeneration_id, output_url, credits_used.2026-05-10T12:34:56Z)generation_id is a UUID — don't parse it, just round-trip it. request_id is not a UUID; it's an opaque req_… token — treat it as a log reference, not an identifier to validate.Every response, success or error, includes:
X-Request-Id — the trace id. Quote this when you write to support.