接入 AI 客户端前,先分清 Base URL、API Key 和模型 ID

服务地址、调用凭证和模型标识各自承担不同作用。按客户端的协议与地址规则填写,完成最小请求验证。

sunny ·

配置 AI 客户端时,通常需要准备服务地址、API Key 和模型标识。三者分别决定请求发送到哪里、用什么凭证调用,以及请求哪个模型。

Base URL:确认客户端如何拼接地址

以控制台或接入文档提供的 API 地址为准。不同客户端可能要求服务根地址、带协议前缀的地址,或完整接口地址。

不要只看输入框名称判断格式。应先阅读对应客户端说明,确认它是否会自动追加路径,避免重复添加或遗漏路径。

API Key:使用模型调用所需的凭证

网页登录状态与客户端的 API 配置是两回事。应在控制台创建调用密钥,并核对额度、有效期、允许模型、分组和 IP 限制。

不要把完整密钥放进文章截图、公开仓库、浏览器前端代码或求助消息中。排查问题时可以提供脱敏标识和错误信息。

模型 ID:复制完整的实际标识

展示名称与接口标识可能不同。大小写、命名空间和版本后缀都可能影响请求。应使用账号或密钥实际可访问的模型,并确认模型支持客户端采用的接口协议。

按顺序完成验证

  1. 确认客户端支持的 API 格式。
  2. 按该客户端要求填写服务地址。
  3. 填入有效的模型调用密钥。
  4. 选择可访问的准确模型标识。
  5. 发送一条简短请求,并查看实际结果和调用记录。

能成功获取模型列表,并不代表所有模型在所有端点上都可以调用。正式接入前,还应测试实际任务使用的端点。

具体配置方式见 客户端接入文档;密钥创建与管理见 API 密钥指南。