基础概念

在配置任何客户端之前，建议先理解以下核心概念。这些概念贯穿所有客户端的接入流程，掌握后可显著降低排错成本。

核心概念说明

概念	说明
API Key	用于请求鉴权的密钥字符串。不同客户端需使用对应分组下创建的密钥，混用将导致鉴权失败。
Base URL	客户端发起请求时指向的服务端地址。地址错误会导致请求直接失败，不会进入鉴权阶段。
分组	JarlessAPI 用于区分不同套餐和用途的配置单元。每个客户端需使用其对应分组的密钥。
模型 ID	客户端实际调用的模型标识符。模型 ID 须与当前分组所支持的模型列表相匹配，否则请求将返回错误。

问题快速定位

遇到接入问题时，按以下顺序逐层排查，可快速缩小问题范围：

1. 连接失败（无响应）：优先检查 Base URL 是否正确填写。
2. 鉴权错误（401）：确认 API Key 是否有效，以及该 Key 是否属于当前客户端对应的分组。
3. 模型不可用：检查模型 ID 是否在当前分组的支持列表中。

理解这些概念后，你应当能够

• 在请求失败时，判断问题属于地址层、鉴权层还是模型映射层，从而针对性排查。
• 明确不同客户端为何不能共用同一分组的密钥。
• 在进入各客户端接入页面时，识别配置中的关键字段并优先核对。

下一步

前往你正在使用的客户端接入页面，按照对应的步骤完成配置。