常见问题

这里整理的是接入过程中最常见的问题。排查时建议先确认三件事：Base URL 是否正确、API Key 是否有效、模型名称是否和控制台一致。

Base URL 应该填什么？

OpenAI 兼容客户端通常填写：

https://api.yylx.io/v1

Claude Code 等 Anthropic 协议工具，请填写控制台展示的 Claude/Anthropic 接入地址。

不要把完整接口路径填进 Base URL。例如 OpenAI 兼容客户端一般不要填写 /chat/completions、/responses 这类路径，客户端会自己拼接。

API Key 可以给多个工具共用吗？

可以，但不推荐。为不同工具创建不同 API Key，更方便统计消耗和处理泄露风险。

推荐按工具创建，例如：

API Key 创建后还能再次查看完整内容吗？

通常不建议依赖二次查看。创建成功后请立即复制保存。如果忘记保存，最安全的处理方式是删除旧 Key，然后重新创建一个新的 Key。

为什么模型名称填写后不可用？

请确认模型名称与控制台展示完全一致。模型名称通常区分大小写，也不要添加多余空格。

如果客户端支持手动添加模型，请直接复制控制台中的完整模型名称。带日期、后缀或横线的模型名不要简写。

为什么客户端提示 401？

通常是 API Key 无效、复制不完整、前后多了空格，或该 Key 已被删除。建议重新复制或创建新 Key。

如果你刚刚禁用、删除或重新创建过 Key，请确认客户端里已经更新到新的 Key。有些桌面客户端会缓存旧配置，保存后需要重启应用。

为什么客户端提示 404？

常见原因是 Base URL 写错，或把完整接口路径填进了 Base URL。OpenAI 兼容客户端一般只需要填到 /v1。

Claude Code 如果填成 https://api.yylx.io/v1 也可能失败，因为它使用的是 Claude/Anthropic 协议配置。请回到 API 密钥页面点击「使用密钥」，复制 Claude Code 对应配置。

为什么客户端提示模型不支持或接口格式错误？

这通常是协议不匹配。Codex、Cursor、Cherry Studio 多数情况下走 OpenAI 兼容接口；Claude Code 走 Claude/Anthropic 相关环境变量。请确认你没有把 Claude Code 的地址填进 OpenAI 客户端，也没有把 OpenAI 的 /v1 地址填进 Claude Code。

为什么响应很慢？

可能与模型本身、上游线路、并发、网络环境有关。可以换模型测试，也可以查看控制台公告或服务状态页。

建议先用短提示测试，例如只让模型回复一句话。如果短提示正常、长任务慢，通常是模型推理或上下文长度导致；如果短提示也慢，再检查网络、服务状态或当前模型可用性。

如何确认请求真的走到了 yylx.io？

配置完成后，发送一条短消息，然后回到 yylx.io 控制台查看使用记录。如果使用记录出现了对应时间的请求，说明客户端已经走到 yylx.io；如果没有记录，通常是客户端仍在使用旧 Provider、旧环境变量或内置服务。

Key 泄露了怎么办？

立即在控制台禁用或删除泄露的 Key，然后重新创建新 Key 并更新客户端配置。如果你不确定泄露范围，建议同时检查最近使用记录，确认是否有异常消耗。