RUN7 / 知识与工具
AI API 接入教程:Base URL、Key 和模型 ID 怎么填
接入 AI API 需要三个匹配的信息:接口地址、具备权限的 API Key、准确的模型 ID。先确认协议,再完成一次短文本调用,最后配置聊天客户端或编程工具。
先选协议,再填模型
同一系列模型可能通过不同协议提供。Claude 可能使用原生 Messages,也可能使用转换后的 Chat Completions;Gemini 也有原生与兼容方式。不同方式在工具调用、推理和图片输入上可能有差异。Run7 在人工确认订单后,私下提供适用地址、模型清单和接入说明。
| 协议 | 常见请求路径 | 认证方式 |
|---|---|---|
| Chat Completions | /v1/chat/completions | Authorization: Bearer … |
| Anthropic Messages | /v1/messages | x-api-key 与 anthropic-version |
| 其他协议 | 以交付说明为准 | 不要推断一定兼容 |
Base URL 不一定是完整请求地址
很多客户端会自动在 Base URL 后拼接接口路径。如果客户端要求填写以 /v1 结尾的地址,却填入 /v1/chat/completions,可能出现重复路径。直接使用 curl 请求时,则需要完整路径。应先看清客户端字段说明,不要反复盲目增删 /v1。
- 从私人交付说明复制地址,避免手工输入出错。
- 模型 ID 要完整一致,版本后缀也不能省略;展示名称不一定是调用 ID。
- Key 放入环境变量或客户端的受保护设置,不能写入公开网页或代码仓库。
先用最小请求验证
macOS/Linux 下安装 cURL 后,可在本地设置环境变量。以下均为占位信息,不是可直接调用的 Run7 地址。示例使用 max_tokens;部分模型需要改为 max_completion_tokens。
export RUN7_BASE_URL="https://YOUR_ENDPOINT/v1"
export RUN7_API_KEY="YOUR_TEST_KEY"
export RUN7_MODEL="YOUR_MODEL_ID"
curl --max-time 60 "$RUN7_BASE_URL/chat/completions" \
-H "Authorization: Bearer $RUN7_API_KEY" \
-H "Content-Type: application/json" \
-d "{"model":"$RUN7_MODEL","messages":[{"role":"user","content":"Reply OK"}],"max_tokens":32}"再接入客户端或编程工具
选择 OpenAI 兼容服务商,填入交付的 Base URL、Key 和模型 ID。第一次只发短文本,先关闭联网、附件和工具调用,再逐项开启。基础文本成功,不等于图片、Agent 工具或 IDE 所有功能都已兼容。
也可以先用 API 基础检测。若提示网络或跨域问题,再用上面的本地请求核对,不应直接判定接口失效。
继续阅读
资料来源与适用范围
依据公开协议资料整理;具体模型、费率和功能以交付信息为准。本文不是对所有客户端版本的兼容保证。
联系获取 Key ↗