API reference - NagaAI Documentation

The reference pages come from the OpenAPI document that NagaAI serves at https://api.naga.ac/openapi.json. Each operation page has a playground that sends real requests with your key.

Base URLs

Client	Base URL
OpenAI SDKs and raw HTTP	`https://api.naga.ac/v1`
Anthropic SDK	`https://api.naga.ac`

Authentication

Endpoints	Key	Header
Chat, images, audio, embeddings, moderations	API key	`Authorization: Bearer` or `x-api-key`
`/v1/account/*`	Provisioning key	`Authorization: Bearer`
`GET /v1/models`, `GET /v1/startups`	None

See Authentication.

Headers

Header	Direction	Meaning
`x-request-id`	Response	The id of the request. Quote it to support, and find it on the Logs page
`x-naga-routing-strategy`	Request and response	On the chat endpoints: the routing strategy to use, and the one that was used. See Routing
`Retry-After`	Response	Seconds to wait, on `429` and some `503` responses

Errors

Every endpoint except /v1/messages returns {"error": {"type", "message"}}, often with code and param. /v1/messages returns {"type": "error", "error": {"type", "message"}}. See Errors.

Versioning

NagaAI has one API version. Changes that affect clients are listed in the Changelog.