跳转到主要内容
PRODUCT DOCUMENTS

快速找到所需文档,高效完成接入与排障

浏览产品文档与友盟 Skill,展开目录并阅读正文。

常见问题

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。