Router One Documentation

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

Get started

1
Create an account
Open the console and create a Router One account.
Sign up
2
Create an API key
Generate a project key in Dashboard -> API Keys.
API Keys
3
Send your first request
Use curl, the OpenAI SDK, or the Anthropic SDK with Authorization: Bearer <key>.
Quickstart

One-click setup (recommended)

One command installs the CLI, writes the gateway config, and verifies your key with a 1-token test request. Existing config files are backed up automatically.

API Key

Create an API key

The key is only inserted into the command locally in your browser; it is never uploaded.

bash

curl -fsSL https://router.one/install/claude-code.sh | bash -s -- sk-your-api-key

Config takes effect immediately — run claude to start.

Review the script before running: /install/claude-code.sh · /install/claude-code.ps1

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"}]
  }'

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

API reference

Chat

POST/v1/chat/completions

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

POST/v1/messages

Create a message — Claude / Anthropic Messages compatible, for Claude-family models.

POST/v1/responses

Create a response — OpenAI Responses API compatible, for GPT-family models.

Images

POST/v1/images/generations

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

POST/v1/images/edits

Edit reference images with text instructions (image-to-image) — multipart file upload, 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.

Guides

Quickstart

First request in five minutes — base URLs, curl, OpenAI SDK, Anthropic SDK, streaming.

CLI setup guide

One-click setup for Claude Code and Codex; manual steps for OpenClaw and Hermes Agent.

CC Switch setup guide

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

FAQ & troubleshooting

Base URLs, 401/402/429 debugging, CLI configuration, and per-request costs.

Model catalog

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

Usage & logs

Per-request model, tokens, cost, latency, and routing decisions.

Common error codes

Common error codes
Code	Meaning	What to do
`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.