Yingtu AI Gateway 使用指南

本文档面向公司内部员工，说明如何获取公司统一发放的 API Key，并把 Yingtu AI Gateway 接入 Hermes、Codex 等常用 AI Agent。员工不用自己花钱购买外部模型服务，也不用自己管理账单；权限、额度和费用由公司统一管理。

获取 API Key 图片模型使用指南查看可用模型查看使用规范

统一网关

所有工具统一接入 https://api.yingtunetwork.com/v1，使用本人账号下的个人密钥。

默认推荐Hermes

配置简单，适合普通员工、企微机器人、固定任务流和内部自动化，升级维护时更不容易把环境改坏。

开发推荐Codex

适合代码阅读、代码修改和本地工程协作。Codex 接 Chat Completions 上游时需要按 CC Switch 本地路由方案配置。

先获取 Yingtu API Key

API Key 是个人凭证，只能由本人使用。当前 New API 控制台入口为「API 密钥」，也可以直接访问 /keys；后续升级如菜单名称调整，请以生产控制台的实际入口为准。

打开 https://api.yingtunetwork.com，使用企业微信或账号登录。
进入控制台 → API 密钥，或直接访问 https://api.yingtunetwork.com/keys。
新建或复制本人 API Key。密钥通常以 sk- 开头，页面若只展示一次，请立即保存到本人受控的位置。
在本机环境变量或 CC Switch 中引用该密钥，推荐环境变量名为 YINGTU_AI_GATEWAY_API_KEY。

不要把 API Key 发给同事代配，不要贴到截图、日志、外部聊天、公共 issue 或代码仓库中。需要协助时，只展示配置项名称，不展示完整密钥。

选择什么工具

使用场景	建议工具	原因
普通员工，不确定该选什么	Hermes	配置少、升级稳定，适合日常资料整理、任务编排和固定流程。
企业微信机器人、内部自动化、长期运行任务	Hermes + CC Switch	Provider 和密钥统一管理，后续换模型或升级工具时更稳。
代码阅读、代码修改、本地工程协作	Codex + CC Switch Routing Service	Codex 适合工程任务；Chat Completions 上游要通过 CC Switch 本地路由转换。
只想先试一个免费客户端	WorkBuddy（附录）	客户端可选，但仍然使用公司统一发放的 Yingtu API Key。

统一填写值

项目	填写值
Provider 名称	`Yingtu AI Gateway` 或 `yingtu`
Base URL / Endpoint	`https://api.yingtunetwork.com/v1`
API Key	本人 `sk-` 密钥，推荐通过 `YINGTU_AI_GATEWAY_API_KEY` 引用。
接口类型	OpenAI-compatible Chat Completions
模型	以模型广场和当前账号权限为准，下面统一用 `your-model` 作为占位。

用 CC Switch 配置和切换模型

CC Switch 官方手册把 Provider Management、Add Provider、Switch Provider、Proxy Service 和 App Routing 作为核心流程。建议用它统一维护 Yingtu Provider，再同步到 Hermes 和 Codex，避免手动改多个配置文件。

CC Switch 新增 Yingtu Provider 的去敏示意图 — 示意图：在 CC Switch 的 Add Provider 面板中新增 Yingtu AI Gateway。图中密钥为占位符。

安装并打开 CC Switch，进入 Provider Management，在主界面右上角点击 +。
优先选择 Universal Provider；如果只给某一个工具使用，再选择 App-specific Provider。
填写 Provider 名称为 Yingtu AI Gateway，Endpoint/Base URL 为 https://api.yingtunetwork.com/v1。
API Key 填本人密钥，或引用 YINGTU_AI_GATEWAY_API_KEY。
点击 Fetch Models 获取模型列表；如果上游暂不支持 /v1/models，就手动填写模型名。
保存后把该 Provider 同步或切换给 Hermes；Codex 则按下方本地路由步骤处理。

Hermes 接入 Yingtu AI Gateway

Hermes 是普通员工的默认推荐。它的配置比较直接，也适合企业微信机器人、固定任务流和内部自动化。如果 CC Switch 已经写入配置，只需要确认当前启用的 Provider 是 Yingtu。

# ~/.hermes/config.yaml
custom_providers:
  - name: yingtu
    base_url: https://api.yingtunetwork.com/v1
    key_env: YINGTU_AI_GATEWAY_API_KEY

model:
  provider: custom:yingtu
  default: your-model

# ~/.hermes/.env
YINGTU_AI_GATEWAY_API_KEY=sk-your-token

Codex 接入 Yingtu AI Gateway

Codex 官方配置使用 ~/.codex/config.toml、model_providers、base_url 和 env_key。同时，Codex 官方手册说明 Chat Completions 支持已废弃且未来会移除； Yingtu AI Gateway 当前按 OpenAI-compatible Chat Completions 使用时，必须优先采用 CC Switch 的 Needs Local Routing / Routing Service 方案，不要简单把 /v1 直接填给 Codex 就认为一定可用。

CC Switch Codex Routing Service 去敏示意图 — 示意图：Codex 使用 Chat Completions 上游时，开启 Needs Local Routing 和 Codex Routing。

在 CC Switch 中为 Codex 新增或同步 Yingtu Provider。
若 Provider 使用 Chat Completions 协议，打开 Needs Local Routing。
在模型映射表中添加真实模型 ID，例如 your-model；保存后重启 Codex 以刷新模型列表。
进入 Settings > Advanced > Proxy Service，启动本地路由服务，默认地址为 http://127.0.0.1:15721。
进入 Routing Service 的 App Routing 区域，启用 Codex Routing。
确认 Codex 配置被指向本地路由地址，再在 Codex 中选择或使用映射后的模型。

检查项	建议值
配置文件	`~/.codex/config.toml`
认证文件	`~/.codex/auth.json` 或环境变量
本地路由地址	`http://127.0.0.1:15721/v1`
API Key	`YINGTU_AI_GATEWAY_API_KEY` 或本人 `sk-` 密钥

调用验证

curl https://api.yingtunetwork.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model",
    "messages": [
      {"role": "user", "content": "请用一句话总结这段内容"}
    ]
  }'

附录：WorkBuddy 可选方案

WorkBuddy 只作为可选免费客户端，不作为主推荐。即使客户端免费，模型调用仍然使用公司统一发放的 Yingtu API Key，不要填写个人购买的外部模型密钥。

{
  "models": [
    {
      "id": "your-model",
      "name": "Yingtu AI Gateway",
      "vendor": "Yingtu",
      "url": "https://api.yingtunetwork.com/v1/chat/completions",
      "apiKey": "${YINGTU_AI_GATEWAY_API_KEY}",
      "supportsToolCall": true,
      "supportsImages": false
    }
  ],
  "availableModels": ["your-model"]
}

官方依据

CC Switch 官网：说明 CC Switch 用于管理多种 AI coding CLI 的 Provider、Proxy、Usage 等能力。
CC Switch User Manual：Provider Management、Add Provider、Proxy Service、App Routing、Codex Chat Completions routing。
OpenAI Codex Advanced Configuration：Codex 的 config.toml、model_providers、base_url 和 env_key 配置口径。

排查清单

遇到 401、模型不可用、Codex 无法启动或调用失败时，先检查下面几项，再联系管理员处理。

API Key 是否来自本人 Yingtu AI Gateway 账号，是否复制完整，前后没有多余空格。
Base URL 是否填写为 https://api.yingtunetwork.com/v1。
模型名称是否和模型广场显示一致，当前账号分组是否有权限。
Codex 使用 Chat Completions 上游时，是否开启 CC Switch 的 Needs Local Routing 和 Codex Routing。
不要把密钥粘贴到外部代码仓库、公共 issue、截图、日志或聊天记录中。