接入 AI 客户端前,先分清 Base URL、API Key 和模型 ID
服务地址、调用凭证和模型标识各自承担不同作用。按客户端的协议与地址规则填写,完成最小请求验证。
sunny ·
配置 AI 客户端时,通常需要准备服务地址、API Key 和模型标识。三者分别决定请求发送到哪里、用什么凭证调用,以及请求哪个模型。
Base URL:确认客户端如何拼接地址
以控制台或接入文档提供的 API 地址为准。不同客户端可能要求服务根地址、带协议前缀的地址,或完整接口地址。
不要只看输入框名称判断格式。应先阅读对应客户端说明,确认它是否会自动追加路径,避免重复添加或遗漏路径。
API Key:使用模型调用所需的凭证
网页登录状态与客户端的 API 配置是两回事。应在控制台创建调用密钥,并核对额度、有效期、允许模型、分组和 IP 限制。
不要把完整密钥放进文章截图、公开仓库、浏览器前端代码或求助消息中。排查问题时可以提供脱敏标识和错误信息。
模型 ID:复制完整的实际标识
展示名称与接口标识可能不同。大小写、命名空间和版本后缀都可能影响请求。应使用账号或密钥实际可访问的模型,并确认模型支持客户端采用的接口协议。
按顺序完成验证
- 确认客户端支持的 API 格式。
- 按该客户端要求填写服务地址。
- 填入有效的模型调用密钥。
- 选择可访问的准确模型标识。
- 发送一条简短请求,并查看实际结果和调用记录。
能成功获取模型列表,并不代表所有模型在所有端点上都可以调用。正式接入前,还应测试实际任务使用的端点。