5.5 接入验证与常见问题
推荐按照以下顺序进行验证:
查询模型列表
运行 Python 最小请求
确认模型正常返回文本
接入 Agent 框架或编码 Agent
增加流式输出、工具调用和多模态能力
首次验证时不要同时加入工具调用、图片、长上下文、多轮记忆和复杂 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 |