# 5.5 接入验证与常见问题

推荐按照以下顺序进行验证：

1. 查询模型列表
2. 运行 Python 最小请求
3. 确认模型正常返回文本
4. 接入 Agent 框架或编码 Agent
5. 增加流式输出、工具调用和多模态能力

首次验证时不要同时加入工具调用、图片、长上下文、多轮记忆和复杂 Agent Workflow，否则出现错误后难以定位。

| **问题现象**                       | **处理建议**                                                                                                                                       |
|------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------|
| Models API 返回 401                | 检查 API Key，以及 Authorization: Bearer 请求头                                                                                                    |
| 提示模型不存在                     | 重新查询 Models API，并使用准确的 data\[\].id                                                                                                      |
| 返回 404                           | 检查 Base URL；普通应用使用 /openai/v1，不要填写错误的完整路径                                                                                     |
| Python 可以调用，但 Agent 工具失败 | 检查工具要求的是 Chat Completions、Anthropic Messages 还是 Responses                                                                               |
| Claude Code 要求登录 Anthropic     | 检查 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 是否在当前终端生效                                                                                 |
| Codex 找不到 anyint Profile        | 检查 ~/.codex/config.toml 中是否存在 \[profiles.anyint\]，并检查 TOML 格式                                                                         |
| Codex 请求无法完成                 | Responses API 当前为 Beta。先使用第 5.3 节的 Chat Completions 示例验证 API Key 和模型，再检查 Codex 版本、目标模型、Responses 协议和流式响应兼容性 |
| 返回 429                           | 降低请求频率，并检查账号额度或并发限制                                                                                                             |
| 返回余额、额度或上游路由相关错误   | 更换已验证模型，并联系 AnyInt 技术支持确认账号和上游状态                                                                                           |
| API Key 已泄露                     | 立即在控制台撤销旧 Key，并创建新 Key                                                                                                               |