Browse documentation

API Reference: Endpoints, Auth & Errors

Complete nRouter API reference: explore OpenAI and Anthropic compatible endpoints for chat completions, embeddings, audio, and intelligent model routing.

nRouter exposes an OpenAI- and Anthropic-compatible API at https://api.nrouter.ai with unified authentication, zero percent (0%) platform fees, and real-time edge telemetry. Standard SDKs connect by setting base URL to https://api.nrouter.ai/v1 with your sk-nrouter-* virtual key.

Pass-through rates (0% fee), 4-phase preflight security, scoped virtual keys, and real-time latency and spend reporting via x-nr-* headers are standard across all endpoints.

Endpoints

16 of 16 endpoints

Chat Completions

/v1/chat/completions

OpenAI-compatible chat completions, streamed or buffered, with guardrails and provider fallback.

Interactive SpecTry request

Messages

Anthropic-compatible Messages endpoint. Point the Anthropic SDK at nRouter by changing the base URL and key.

Interactive SpecTry request

Count Tokens

/v1/messages/count_tokens

Count the input tokens of a Messages request before you send it.

Interactive SpecTry request

Responses API

The OpenAI Responses API wire, including tool use and multimodal input.

Interactive SpecTry request

Text Completions

/v1/completions

Legacy text completions for single-turn prompt-and-response workflows.

Interactive SpecTry request

Capabilities

Retrieve runtime gateway capabilities, supported providers, active models, and available modalities.

Interactive SpecTry request

List Models

List the models available through nRouter, across every connected provider.

Interactive SpecTry request

Retrieve Model

/v1/models/{model_id}

Retrieve one model by its ID.

Interactive SpecTry request

Embeddings

Generate high-dimensional vector representations for semantic search, RAG, and classification.

Interactive SpecTry request

Image Generations

/v1/images/generations

Generate visual assets using state-of-the-art diffusion and multimodal models.

Interactive SpecTry request

Text to Speech

/v1/audio/speech

Transform text into natural lifelike spoken audio in multiple voices and formats.

Interactive SpecTry request

Speech to Text

/v1/audio/transcriptions

Transcribe spoken audio into accurate text transcripts with timestamps and language detection.

Interactive SpecTry request

Audio Translations

/v1/audio/translations

Translate non-English speech directly into English text transcripts.

Interactive SpecTry request

Start Video Job

Initiate async video generation jobs. Billed once on initiation; polling and download are free.

Interactive SpecTry request

Poll Video Job

/v1/videos/{id}

Check the processing status of an active video generation task (unmetered / free).

Interactive SpecTry request

Download Video

/v1/videos/{id}/content

Download the completed video content file (unmetered / free).

Interactive SpecTry request

Authentication

Every request takes your virtual key (sk-nrouter-...) as a Bearer token:

curl https://api.nrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-nrouter-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.5","messages":[{"role":"user","content":"Hello!"}]}'

See Chat Completions for streaming and schemas.

Suggest an edit

Was this page helpful?

On this page

Endpoints Authentication