#集成前检查

完成下面的检查，可以避免大多数 401、404、模型不存在和“聊天正常但工具调用失败”问题。

#1. 创建专用 API Key

在 API Keys 为每个工具创建独立 Key。建议设置用途名称、有效期、额度和模型限制。

#2. 复制准确模型 ID

从模型目录复制，不要根据展示名称猜测。模型列表拉取失败时，大多数客户端仍允许手动输入 ID。

#3. 确认协议

• Codex 优先使用 Responses；
• Claude Code 使用 Anthropic Messages；
• Gemini CLI 使用 Gemini-compatible；
• 多数桌面聊天客户端优先使用 Chat Completions。

#4. 确认 URL 输入类型

检查字段说明中是否写着：

• Base URL / API Base；
• Service Root / Host；
• Endpoint / API URL；
• 是否自动追加 /v1 或 /chat/completions。

#5. 分层验证

按以下顺序逐步增加复杂度：

1. 短文本、非流式；
2. 短文本、流式；
3. 多轮对话；
4. Tool Calling；
5. 图片或文件输入；
6. 长上下文和自动任务。

每一步都在使用记录确认模型、Endpoint、状态和费用。

#6. 保存可排查信息

记录工具版本、配置文件位置、协议、模型 ID 和最后核对日期。分享配置时把真实 Key 替换为 YOUR_API_KEY。