# NagaAI Documentation

## Docs

- [Account Management](https://docs.naga.ac/account/account-management.md): Manage operational account workflows with provisioning-key-protected endpoints.
- [API Keys](https://docs.naga.ac/account/api-keys.md): Create, list, update, and delete API keys with provisioning-key authentication.
- [Balance and Activity](https://docs.naga.ac/account/balance-and-activity.md): Inspect account balance, request volume, costs, top models, and per-key activity.
- [Privacy and Logging](https://docs.naga.ac/account/privacy-and-logging.md): Summary of how we handle prompts, outputs, and operational logs.
- [Get account activity](https://docs.naga.ac/api-reference/account/get-account-activity.md): Return request counts, token usage, costs, top models, and per-key usage for a configurable lookback window.
- [Get account balance](https://docs.naga.ac/api-reference/account/get-account-balance.md): Return the current balance for the authenticated provisioning key.
- [Create an API key](https://docs.naga.ac/api-reference/api-keys/create-an-api-key.md): Create a new API key for the authenticated account and return the plaintext key once.
- [Delete an API key](https://docs.naga.ac/api-reference/api-keys/delete-an-api-key.md): Delete an API key owned by the authenticated account. This operation is irreversible.
- [Get an API key](https://docs.naga.ac/api-reference/api-keys/get-an-api-key.md): Return metadata for a single API key owned by the authenticated account.
- [List API keys](https://docs.naga.ac/api-reference/api-keys/list-api-keys.md): List API keys for the authenticated account without returning plaintext key material.
- [Update an API key](https://docs.naga.ac/api-reference/api-keys/update-an-api-key.md): Update API key metadata such as its name, enabled state, credit limit, or expiration.
- [Create a transcription](https://docs.naga.ac/api-reference/audio/create-a-transcription.md): Upload an audio file and receive a text transcription.
- [Create a translation](https://docs.naga.ac/api-reference/audio/create-a-translation.md): Upload an audio file and receive translated English text output.
- [Create speech](https://docs.naga.ac/api-reference/audio/create-speech.md): Convert text into speech audio and stream the generated bytes.
- [Create a chat completion](https://docs.naga.ac/api-reference/chat-completions/create-a-chat-completion.md): Generate an OpenAI-compatible chat completion from conversation messages. Supports streaming, multimodal content, structured outputs, and tool calling.
- [Create embeddings](https://docs.naga.ac/api-reference/embeddings/create-embeddings.md): Convert one or more text inputs into vector embeddings.
- [Edit images](https://docs.naga.ac/api-reference/images/edit-images.md): Edit one or more uploaded images with a prompt and optional mask.
- [Generate images](https://docs.naga.ac/api-reference/images/generate-images.md): Create one or more images from a text prompt.
- [Create a message](https://docs.naga.ac/api-reference/messages/create-a-message.md): Generate an Anthropic-compatible message response from Messages API input. Supports streaming, tool use, and multimodal content blocks.
- [List models](https://docs.naga.ac/api-reference/models/list-models.md): List available models, pricing, aliases, and supported endpoint metadata. This endpoint can be called anonymously or with standard API authentication.
- [Create a moderation](https://docs.naga.ac/api-reference/moderations/create-a-moderation.md): Classify text or image inputs against moderation categories and scores.
- [API Reference](https://docs.naga.ac/api-reference/overview.md): Exact endpoint contracts, request builders, auth requirements, and response schemas.
- [Create a response](https://docs.naga.ac/api-reference/responses/create-a-response.md): Generate an OpenAI-compatible Responses API object from text or structured input items, with optional tools and streaming events.
- [List startups](https://docs.naga.ac/api-reference/startups/list-startups.md): Return public metadata for startups and providers represented in the catalog.
- [Audio API](https://docs.naga.ac/api/audio.md): Convert text to speech and turn audio into text with transcription and translation endpoints.
- [File Formats and Uploads](https://docs.naga.ac/api/audio/file-formats-and-uploads.md): Understand multipart uploads, validation, and common file issues for Audio API operations.
- [Speech to Text](https://docs.naga.ac/api/audio/speech-to-text.md): Upload audio and receive a text transcription.
- [Speech Translation](https://docs.naga.ac/api/audio/speech-translation.md): Upload audio and receive translated English text.
- [Text to Speech](https://docs.naga.ac/api/audio/text-to-speech.md): Convert text into streamed audio bytes.
- [Chat Completions API](https://docs.naga.ac/api/chat-completions.md): OpenAI-compatible chat endpoint for existing messages-based integrations.
- [Migration to Responses](https://docs.naga.ac/api/chat-completions/migration-to-responses.md): Move from Chat Completions to the recommended Responses API when you are ready.
- [Multimodal Content](https://docs.naga.ac/api/chat-completions/multimodal-content.md): Send text, images, files, and audio through the Chat Completions compatibility layer.
- [Reasoning](https://docs.naga.ac/api/chat-completions/reasoning.md): Understand reasoning-related controls and output on the Chat Completions compatibility surface.
- [Streaming](https://docs.naga.ac/api/chat-completions/streaming.md): Stream OpenAI-compatible chat completion chunks.
- [Structured Outputs](https://docs.naga.ac/api/chat-completions/structured-outputs.md): Use JSON mode or schema-shaped output in the Chat Completions compatibility layer.
- [Tokens and Usage](https://docs.naga.ac/api/chat-completions/tokens-and-usage.md): Usage tracking in the Chat Completions compatibility layer.
- [Tool Calling](https://docs.naga.ac/api/chat-completions/tool-calling.md): Use OpenAI-style tools and tool calls in the Chat Completions compatibility layer.
- [Web Search](https://docs.naga.ac/api/chat-completions/web-search.md): Enable search on the Chat Completions compatibility surface with the real request field this endpoint supports.
- [Embeddings API](https://docs.naga.ac/api/embeddings.md): Generate vector embeddings for search, retrieval, and clustering workflows.
- [Batch Inputs](https://docs.naga.ac/api/embeddings/batch-inputs.md): Send multiple embedding inputs in one request and interpret the indexed results.
- [Output Formats](https://docs.naga.ac/api/embeddings/output-formats.md): Choose between JSON float vectors and base64-encoded embeddings.
- [Retrieval Patterns](https://docs.naga.ac/api/embeddings/retrieval-patterns.md): Use the Embeddings API in practical retrieval and ranking workflows.
- [Images API](https://docs.naga.ac/api/images.md): Generate or edit images with direct image-focused endpoints.
- [Image Edits](https://docs.naga.ac/api/images/image-edits.md): Edit one or more uploaded images with a prompt and optional mask.
- [Image Generation](https://docs.naga.ac/api/images/image-generation.md): Generate one or more images from a text prompt.
- [Messages API](https://docs.naga.ac/api/messages.md): Anthropic-compatible messages endpoint for Claude-style integrations and agent tooling.
- [Documents and PDFs](https://docs.naga.ac/api/messages/documents-and-pdfs.md): Send document blocks and PDF sources through the Messages compatibility layer.
- [Migration to Responses](https://docs.naga.ac/api/messages/migration-to-responses.md): Move from Anthropic-style Messages contracts to the recommended Responses API when it makes sense.
- [Streaming](https://docs.naga.ac/api/messages/streaming.md): Stream Anthropic-style Messages API events.
- [Thinking Blocks](https://docs.naga.ac/api/messages/thinking-blocks.md): Understand thinking and reasoning-style content in the Messages compatibility layer.
- [Tokens and Usage](https://docs.naga.ac/api/messages/tokens-and-usage.md): Usage tracking in the Anthropic-compatible Messages API.
- [Tool Use](https://docs.naga.ac/api/messages/tool-use.md): Use Anthropic-style tool_use and tool_result blocks.
- [Web Search](https://docs.naga.ac/api/messages/web-search.md): Enable Anthropic-style server web search on the Messages compatibility surface.
- [Moderations API](https://docs.naga.ac/api/moderations.md): Classify text and image inputs against moderation categories and scores.
- [Image Moderation](https://docs.naga.ac/api/moderations/image-moderation.md): Classify remote images with typed moderation inputs.
- [Mixed Inputs](https://docs.naga.ac/api/moderations/mixed-inputs.md): Moderate text and image content together in one request.
- [Text Moderation](https://docs.naga.ac/api/moderations/text-moderation.md): Classify text inputs for moderation decisions.
- [Responses API](https://docs.naga.ac/api/responses.md): Start here for new NagaAI LLM integrations.
- [Conversation State](https://docs.naga.ac/api/responses/conversation-state.md): Model multi-turn context correctly when using the Responses API.
- [Multimodal Inputs](https://docs.naga.ac/api/responses/multimodal-inputs.md): Send text, images, audio, and files through the Responses input model.
- [Reasoning](https://docs.naga.ac/api/responses/reasoning.md): Understand reasoning-related output in the Responses API.
- [Streaming](https://docs.naga.ac/api/responses/streaming.md): Stream semantic Responses API events and reconstruct the final result correctly.
- [Structured Outputs](https://docs.naga.ac/api/responses/structured-outputs.md): Use schema-shaped output with the Responses API.
- [Text Generation](https://docs.naga.ac/api/responses/text-generation.md): Generate text with the Responses API and understand the response item model.
- [Tokens and Usage](https://docs.naga.ac/api/responses/tokens-and-usage.md): Understand how token usage, cached tokens, and reasoning tokens are reported in the Responses API.
- [Tool Calling](https://docs.naga.ac/api/responses/tool-calling.md): Call your own functions through the Responses API and understand tool items on the wire.
- [Web Search](https://docs.naga.ac/api/responses/web-search.md): Understand where search-capable requests fit into the Responses API workflow.
- [How Billing Works](https://docs.naga.ac/build/billing.md): How credits, token pricing, and paid-model access work on NagaAI.
- [Error Handling](https://docs.naga.ac/build/error-handling.md): Handle synchronous and streaming errors across NagaAI APIs.
- [Multimodal Inputs](https://docs.naga.ac/build/multimodal-inputs.md): Compare how text, images, files, audio, and documents are represented across the supported APIs.
- [Production Checklist](https://docs.naga.ac/build/production-checklist.md): A practical checklist for shipping against NagaAI APIs reliably.
- [Rate Limits](https://docs.naga.ac/build/rate-limits.md): Understanding rate limits and access tiers for NagaAI models.
- [Reasoning](https://docs.naga.ac/build/reasoning.md): Compare reasoning-related output across Responses, Chat Completions, and Messages.
- [Streaming](https://docs.naga.ac/build/streaming.md): Stream model output and events from Responses, Chat Completions, and Messages APIs.
- [Structured Outputs](https://docs.naga.ac/build/structured-outputs.md): Compare schema-shaped output patterns across the supported generation APIs.
- [Tokens and Usage](https://docs.naga.ac/build/tokens-and-usage.md): Understand how models process data as tokens and how usage is categorized for billing.
- [Tool Calling](https://docs.naga.ac/build/tool-calling.md): Let models call your application-defined functions across the supported generation APIs.
- [Web Search](https://docs.naga.ac/build/web-search.md): Understand how search-capable behavior differs by model and API surface.
- [Authentication](https://docs.naga.ac/get-started/authentication.md): Understand how to authenticate primary inference requests and administrative account operations.
- [Choose an API](https://docs.naga.ac/get-started/choose-an-api.md): Decide whether to use Responses, Embeddings, Audio, Moderations, Images, or one of the compatibility layers.
- [Models](https://docs.naga.ac/get-started/models.md): Learn where to browse models in NagaAI, how free and paid access works, and how to choose a model for your task.
- [Overview](https://docs.naga.ac/get-started/overview.md): A unified AI platform for model access, API routing, and tool-compatible integrations.
- [Quickstart](https://docs.naga.ac/get-started/quickstart.md): Get your API key and make your first request to NagaAI using official SDKs.
- [Claude Code](https://docs.naga.ac/integrations/agents/claude-code.md): Use Claude Code with NagaAI to access multiple models through a single Anthropic-compatible endpoint.
- [Codex CLI](https://docs.naga.ac/integrations/agents/codex-cli.md): Use Codex CLI with NagaAI by adding a custom provider that points to NagaAI's OpenAI-compatible API.
- [Gemini CLI](https://docs.naga.ac/integrations/agents/gemini-cli.md): Use Gemini CLI with NagaAI by pointing an OpenRouter-compatible Gemini CLI fork to NagaAI’s OpenAI-compatible API.
- [Kilo Code](https://docs.naga.ac/integrations/agents/kilo-code.md): Use the Kilo Code VS Code extension with NagaAI via the OpenAI-compatible API.
- [OpenClaw](https://docs.naga.ac/integrations/agents/openclaw.md): Connect OpenClaw to NagaAI through the OpenAI-compatible API.
- [OpenCode](https://docs.naga.ac/integrations/agents/opencode.md): Use OpenCode with NagaAI by adding a custom provider to the OpenCode config file.
- [Other Integrations](https://docs.naga.ac/integrations/agents/others.md): Connect NagaAI to any app or tool that supports OpenAI-compatible APIs (and more).
- [Roo Code](https://docs.naga.ac/integrations/agents/roo-code.md): Use the Roo Code VS Code extension with NagaAI via the OpenAI-compatible API.
- [Chat Interface](https://docs.naga.ac/product/chat-interface.md)
- [Playground](https://docs.naga.ac/product/playground.md)

## OpenAPI Specs

- [naga-api](https://docs.naga.ac/openapi/naga-api.json)
- [openapi](https://docs.naga.ac/api-reference/openapi.json)