[codex] rename site API request wording (#423)

* rename site api request wording * replace real site example domains
2026-04-05 19:16:08 +08:00
parent 5b005d8412
commit ef1962d10b
15 changed files with 84 additions and 67 deletions
@@ -28,7 +28,7 @@ npm run docs:build
 |------|--------|------------|
 | 对外第一印象、产品定位、核心入口 | [文档首页](/) | 需要调整公开落地页信息架构、首页 CTA 或首屏导航时 |
 | 新用户部署与首条请求 | [快速上手](./getting-started.md) | 新安装流程、默认端口、首次调用步骤变化时 |
-| 上游平台选择与接法 | [上游接入](./upstream-integration.md) | 平台支持范围、官方预设、AI 请求地址池、自动识别规则变化时 |
+| 上游平台选择与接法 | [上游接入](./upstream-integration.md) | 平台支持范围、官方预设、API 请求地址池、自动识别规则变化时 |
 | Provider OAuth 授权 | [OAuth 管理](./oauth.md) | 支持的 OAuth provider、授权流程、回调方式或自动重绑能力变化时 |
 | 生产部署与回滚 | [部署指南](./deployment.md) | Docker Compose、反向代理、升级回滚策略变更时 |
 | K3s / Helm 高级升级面板 | [K3s 更新中心（高级）](./k3s-update-center.md) | 需要说明谁适合使用更新中心、helper 怎么配、K3s/Helm 发布链路怎么接入时 |
@@ -144,7 +144,7 @@ npm run dev
 - 平台通常可自动检测；如果因为防护页、反向代理或特殊路径导致检测失败，再手动选择。
 - 可选是否开启系统代理，方便国内机器访问国外中转站。
 - 可选站点权重，站点权重越大，路由将更加频繁使用这个站点的模型。
- 如果这个站点的控制台 URL 和真实 AI 请求地址不同，不要直接把主站点 URL 改掉，而是在表单下方补「AI 请求地址池」。
+- 如果这个站点的控制台 URL 和真实 API 请求地址不同，不要直接把主站点 URL 改掉，而是在表单下方补「API 请求地址池」。

 > [!IMPORTANT]
 > 通用平台常见写法是填控制台地址或 provider base URL；但如果你选的是**官方预设**，请保留预设自动带出的完整路径，哪怕它本来就包含 `/v1`、`/anthropic` 或 `/api/coding/...`。
@@ -24,7 +24,7 @@ features:
    details: 从部署到第一条请求，按步骤完成最小可用环境搭建。
    link: /getting-started
  - title: 上游接入
-    details: 按平台类型、官方预设和 AI 请求地址池的现状，快速判断站点该怎么接。
+    details: 按平台类型、官方预设和 API 请求地址池的现状，快速判断站点该怎么接。
    link: /upstream-integration
  - title: OAuth 管理
    details: 直接接入 Codex、Claude、Gemini CLI、Antigravity 等 provider 授权账号。
@@ -228,7 +228,7 @@ curl -sS "${METAPI_ADMIN_BASE_URL}/api/sites/detect" \
 | `isPinned` | `boolean` | 否 | 是否置顶 |
 | `sortOrder` | `number` | 否 | 排序值，非负整数 |
 | `globalWeight` | `number` | 否 | 站点全局权重，必须为正数 |
-| `apiEndpoints` | `array` | 否 | 仅用于 AI 请求的数据面地址池；不替代主站点 URL |
+| `apiEndpoints` | `array` | 否 | 仅用于 API 请求的数据面地址池；不替代主站点 URL |

 示例：

@@ -443,18 +443,18 @@ CPA 这类站点推荐直接使用 **API Key**：
 2. Metapi 会向该 URL 发送 POST 请求执行签到
 3. 请求头自动携带账号凭证

-### AI 请求地址池
+### API 请求地址池

-现在不少站点已经不是“一个 URL 同时负责后台面板和 `/v1/*` AI 请求”。
+现在不少站点已经不是“一个 URL 同时负责后台面板和 `/v1/*` API 请求”。

 Metapi 当前支持把这两层拆开：

 - **主站点 URL**：用于登录、签到、后台接口、系统访问令牌管理
- **AI 请求地址池**：用于真正转发 `/v1/*`、`/chat/completions`、`/responses` 等模型请求
+- **API 请求地址池**：用于真正转发 `/v1/*`、`/chat/completions`、`/responses` 等模型请求

-适合填写 AI 请求地址池的场景：
+适合填写 API 请求地址池的场景：

-1. 控制台地址和 AI 网关地址不同
+1. 控制台地址和 API 网关地址不同
 2. 同一个站点有多个 API host，需要健康切换
 3. 你想保留面板地址不变，只把模型流量导向专用网关

@@ -462,7 +462,7 @@ Metapi 当前支持把这两层拆开：

 ```text
 主站点 URL = 控制面
-AI 请求地址池 = 数据面
+API 请求地址池 = 数据面
 ```

 ---
@@ -572,7 +572,7 @@ Metapi 会定期抓取已接入站点的公告，并在首次发现时写入站
   - 官方预设则相反，**不要**把预设自动带出的 `/v1` / `/anthropic` / `/api/coding/...` 手动删掉
 2. 网络不通（检查代理配置或防火墙）
 3. 凭证无效（重新验证账号密码、Session 或 API Key）
-4. 主站点 URL 和真实 AI 请求地址不同，但还没配置 AI 请求地址池
+4. 主站点 URL 和真实 API 请求地址不同，但还没配置 API 请求地址池

 **解决方法：**

@@ -676,7 +676,7 @@ Metapi 会定期抓取已接入站点的公告，并在首次发现时写入站
 - **每周检查：** 账号健康状态、余额预警
 - **每月清理：** 禁用长期不可用的站点和账号
 - **凭证轮换：** 定期更新 Access Token 和 API Key
- **官方预设站点：** 新增模型时记得补充推荐模型和 AI 请求地址池
+- **官方预设站点：** 新增模型时记得补充推荐模型和 API 请求地址池

 ---