外部集成
兼容性和连接指南
通过五项核对，稳定地连接 IDE 插件、桌面客户端和自定义工具。
核对五项连接设置
| 检查项 | 必须匹配什么 |
|---|---|
| 令牌分组 | 必须允许 API 密钥使用所选模型。 |
| 协议 | 根据客户要求选择“Anthropic Messages”、“Responses”或“Chat Completions”。 |
| API 地址 | 使用客户端期望的路径形状，仅在需要时包括 /v1。 |
| 请求头 | 发送正确的授权请求头和任何上游所需的用户代理。 |
| 模型 ID | 复制 模型广场 中显示的确切模型 ID。 |
推荐的连接顺序
- 为客户端创建单独的 API 密钥，以便使用和撤销保持隔离。
- 在输入 URL 之前选择协议，因为客户端会附加不同的端点路径。
- 输入基本 URL、API 密钥和确切的模型 ID。
- 仅当客户端或配置的上游需要自定义请求头时才启用自定义请求头。
- 在启用工具或长上下文之前运行最小请求并检查请求日志。
通过状态码诊断
| 状态码 | 首先检查 |
|---|---|
| 401 | API 密钥、授权方案、隐藏空间和过期凭据。 |
| 403 | 令牌组、模型权限、客户端请求头和上游访问策略。 |
| 404 | 基本 URL 后缀、端点协议和确切的模型 ID。 |
| 429 | 余额、配额、速率限制和重试频率。 |
| 5xx | 请求日志、上游状态以及较小的测试请求是否成功。 |