Run7 AI联系获取 Key ↗
RUN7 / 知识与工具

AI API 接入教程:Base URL、Key 和模型 ID 怎么填

作者:Run7 AI · 更新:2026-11-17

接入 AI API 需要三个匹配的信息:接口地址、具备权限的 API Key、准确的模型 ID。先确认协议,再完成一次短文本调用,最后配置聊天客户端或编程工具。

先选协议,再填模型

同一系列模型可能通过不同协议提供。Claude 可能使用原生 Messages,也可能使用转换后的 Chat Completions;Gemini 也有原生与兼容方式。不同方式在工具调用、推理和图片输入上可能有差异。Run7 在人工确认订单后,私下提供适用地址、模型清单和接入说明。

协议常见请求路径认证方式
Chat Completions/v1/chat/completionsAuthorization: Bearer …
Anthropic Messages/v1/messagesx-api-key 与 anthropic-version
其他协议以交付说明为准不要推断一定兼容

Base URL 不一定是完整请求地址

很多客户端会自动在 Base URL 后拼接接口路径。如果客户端要求填写以 /v1 结尾的地址,却填入 /v1/chat/completions,可能出现重复路径。直接使用 curl 请求时,则需要完整路径。应先看清客户端字段说明,不要反复盲目增删 /v1。

先用最小请求验证

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 基础检测。若提示网络或跨域问题,再用上面的本地请求核对,不应直接判定接口失效。

继续阅读

全部知识文章 · API 基础检测

资料来源与适用范围

依据公开协议资料整理;具体模型、费率和功能以交付信息为准。本文不是对所有客户端版本的兼容保证。