Agent 接入
Agent 接入排障
诊断 API Key、模型、Base URL、配置优先级、流式输出和客户端兼容问题。
请在完成对应 Agent 工具的配置步骤后，使用本页继续排查。
按顺序检查连接
- 确认 API Key 可以查询模型。
- 确认配置的模型 ID 对同一个 Key 可见。
- 确认 Base URL 与客户端要求的协议一致。
- 检查终端环境变量是否覆盖配置文件。
- 先运行不含工具调用的最小提示词，再测试流式、工具或媒体能力。
Key 和模型预检
export ANYINT_API_KEY="your-anyint-api-key"
curl https://api.anyint.ai/openai/v1/models \
-H "Authorization: Bearer $ANYINT_API_KEY"Anthropic 兼容客户端使用：
curl https://api.anyint.ai/anthropic/v1/models \
-H "x-api-key: $ANYINT_API_KEY" \
-H "anthropic-version: 2023-06-01"如果模型查询失败，应先修复 Key 或账号权限，再修改 Agent 配置。
Base URL 速查
| 客户端协议 | Base URL |
|---|---|
| OpenAI Chat Completions | https://api.anyint.ai/openai/v1 |
| OpenAI Responses | https://api.anyint.ai/openai/v1 |
| Anthropic 兼容 | https://api.anyint.ai/anthropic |
| Gemini 兼容 | https://api.anyint.ai/gemini/v1beta |
除非客户端明确要求完整请求 URL，否则不要在 Base URL 后追加具体端点。
现象和处理方式
| 现象 | 常见原因 | 下一步 |
|---|---|---|
401 或鉴权错误 | Key 缺失、无效或带有错误前缀 | 去掉多余空格，并使用所选 API 家族要求的鉴权字段。 |
404 或找不到路由 | Base URL 使用了错误前缀或端点 | 从上表重新复制 Base URL。 |
| 找不到模型 | 使用了营销名称，而不是账号可见的模型 ID | 使用同一个 Key 查询 Models API，复制 data[].id。 |
| 仍然使用旧 Provider | 环境变量覆盖了配置文件 | 重新打开终端，并检查 OPENAI_*、ANTHROPIC_*、GEMINI_* 和 ANYINT_API_KEY。 |
| 响应开始后一直不结束 | 客户端与该路由或模型的流式协议不兼容 | 先尝试最小非流式 API 请求，再检查 API 家族状态和限制。 |
| 工具调用失败 | 客户端 Schema 与所选 API 家族不一致 | 确认客户端使用对应家族的工具调用格式。 |
| Gemini 文件输入失败 | fileData.fileUri 使用了本地路径 | 改用公网 HTTPS URL 或内联数据。 |
保护 API Key
- 不要在公开 Issue、截图、聊天记录或文档中粘贴真实 Key。
- 不要提交包含 Key 的本地 Agent 配置。
- Key 暴露后立即轮换。
- 条件允许时，为不同人员、项目或自动化环境使用不同 Key。
提供有效的支持信息
联系 AnyInt 支持 时，请提供：
- Agent 工具及版本
- 所选 API 家族
- 不含 Key 的 Base URL
- 模型 ID
- 已移除敏感信息的 HTTP 状态或客户端错误
- 同一个 Key 是否可以正常查询模型
不要提供 API Key 本身。