API 总览导读
先把路径、认证和请求基本约定弄对，再谈模型、路由和治理。
TheRouter.ai 对大多数用户来说，是一个 OpenAI-compatible 入口加上路由扩展。 常见问题通常不在功能数量，而在路径、头部和模型命名没有先对齐。
最小认知模型
先把 3 个路径族分清：推理请求走
/v1/*，客户侧 dashboard 能力走 /v1/customer/*， 兼容层保留在 /api/v1/*。3 类核心路径
/v1/*
适合：
chat completions
models
embeddings
这是你最常用的核心推理路径最短首个请求
bash
curl https://api.therouter.ai/v1/chat/completions \
-H "Authorization: Bearer $THEROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "anthropic/claude-sonnet-4.5",
"messages": [{"role":"user","content":"Say hello"}]
}'先记住这几点
- 所有请求都带
Authorization: Bearer sk-...。 - 每次响应都会返回
x-request-id。 - 模型 ID 默认写成
provider/model。 - 管理和账单接口在
/v1/customer/*。
最常见的初级错误
text
1. 仍然打上游 provider 的原始 base URL
2. 把 customer 接口当成 inference 接口调用
3. 模型 ID 没写 provider/model
4. 忘了记录 x-request-id，导致后续排障变慢