常见问题
1 返回 401
先确认 API Key 来自 U-Router 控制台,再确认客户端实际发送的鉴权 Header。
2 返回 404
重点检查客户端是否自动追加 /v1/chat/completions、/v1/messages 或 /v1/responses。U-Router 官网已公开 POST /api/llm/v1/chat/completions,因此使用 OpenAI-compatible 客户端时,应确认 Base URL 拼接后的最终地址与该路径一致。/chat 和 /chat/stream 是另一组原生相对路径,不要与标准路径重复拼接。
3 auto 无法识别
确认当前接口是否允许 model: "auto",以及客户端是否要求预先注册模型;需要时把 auto 作为自定义模型 ID 添加。仍失败时,应先核对 Base URL、请求路径和请求体,不要直接假设可改用某个具体文本模型 ID。
4 Claude Code 连接失败
不要将 OpenAI 兼容 Base URL 直接填入 ANTHROPIC_BASE_URL。只有 U-Router 提供 Anthropic Messages API 时才能直接连接,否则需要协议转换。
5 Codex 报 wire_api 不支持
Codex 默认使用 WebSocket 传输,会绕过 base_url 直连 OpenAI。需在 config.toml 中设置 transport_kind = responses_http 强制走 HTTP/SSE。