Router One Documentation

A concise guide from account setup to calling the OpenAI-compatible API gateway.

What is Router One?

Router One is a unified LLM API gateway. It gives your application one OpenAI-compatible endpoint for model calls, smart routing, fallback, budgets, and request-level observability.

Core value

Use one API key and one base URL for common LLM tools and models. Router One handles provider differences, cost tracking, and routing behind the gateway.

Main API entry points:

text

OpenAI-compatible API / Codex CLI / OpenClaw / Hermes Agent:
https://api.router.one/v1

Claude Code / Anthropic-compatible endpoint:
https://api.router.one

Get started

Create an account

Open the console and create a Router One account.

Create an API key

Generate a project key in Dashboard -> API Keys.

API Keys

Send your first request

Use the Chat Completions endpoint with Authorization: Bearer <key>.

Endpoint reference

Example request

bash

curl https://api.router.one/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

API reference

Chat

POST/v1/chat/completions

Create a chat completion — OpenAI Chat Completions compatible, streaming and non-streaming.

Images

POST/v1/images/generations

Generate images from text — multiple sizes and qualities, returns URL or base64.

Videos

POST/v1/videos/generations

Submit a video generation task — async execution, returns a task_id to poll.

GET/v1/videos/generations/{task_id}

Check video generation status — progress, final video URL, or failure reason.

Configuration guides

CLI setup guide

Configure Claude Code, Codex CLI, OpenClaw, and Hermes Agent with Router One.

CC Switch setup guide

Connect Claude Code or Codex to Router One with a desktop app — no manual environment variables.

Model catalog

Compare model IDs, pricing, context windows, and capabilities.

Common error codes

`401`	Invalid or missing API key	Check the Authorization header.
`402`	Insufficient balance	Top up or adjust the budget.
`429`	Rate limit exceeded	Check Dashboard -> Logs, then reduce request rate or contact support to raise limits.
`500`	Internal server error	Retry shortly; contact support if it persists.