跳到正文
EN

XiuAI Agent 集成

按首次配置、替换已有和对话协助三种路径,选择 Agent 的真实配置入口。

更新于 复核于
查看 Markdown

本页对应 XiuAI“Agent 集成”产品页。公开页提供占位配置;在 XiuAI 控制台选择 API Key 和可用模型,再用“检查实际请求”确认连接。ChatGPT 桌面端先选 macOS、Windows 或 Linux,在应用外配置本地 Codex;官方 API 密钥登录框不提供 XiuAI Base URL。要先比较 Codex、Claude Code 与 Cursor 的协议边界,可阅读 Agent 开发场景。

三种配置方式

  • 首次配置:默认路径。创建或选择专用 API Key,再按客户端要求添加连接。
  • 替换已有:保留原 provider、Base URL、模型和凭据来源作为回滚点,只新增或修改 XiuAI 项。
  • 对话协助:仅在 Agent 能访问目标配置文件或终端时提供。Agent 不读取 API Key,也不代替重启和新建任务。

集成目录

项目 主要入口 替换已有 对话协助 模型处理
ChatGPT 应用外配置;桌面端按操作系统,CLI/IDE 按启动环境 备份后新增 provider 可合并非密钥 TOML 首次配置需要模型;已有同名 ID 可保留
Claude Code Claude Desktop、CLI 或 VS Code 先记录原连接 不提供 从网关发现,再在客户端选择
Cursor Cursor Settings → Models 记录原设置后开启 Base URL 覆盖 不提供 只覆盖符合条件的 OpenAI 系模型
DeepSeek Harness Settings → Models 新增或编辑 xiurouter 不提供 用 Fetch available models 选择
OpenCode /connect 与 opencode.json 更新同名凭据并保留其他 provider 可合并非密钥 JSON 必须显式列出模型
OpenWork 工作区 .config/opencode/opencode.json 合并工作区 provider 不提供 每个工作区单独配置模型
Cline Cline 设置 记录原连接后切换 不提供 必须填写精确 Model ID
Continue config.yaml 与本地 Secret 追加模型项 可合并非密钥 YAML 固定走 Chat Completions
OpenClaw ~/.openclaw/openclaw.json 合并 provider 和模型白名单 可合并非密钥 JSON provider 和白名单都要显式列出模型
Hermes Agent 会话外运行 hermes model 新增 Custom endpoint 不提供 在 Hermes 中从 endpoint 列表选择
Aider 环境变量与 --model 在独立终端临时切换 不提供 启动时使用 openai/模型ID
Open WebUI Admin Settings → Connections 新增独立连接 不提供 通过 /v1/models 自动发现
LibreChat librechat.yaml 追加 custom endpoint 不提供 models.default 必填,fetch 扩充
Vercel AI SDK 服务端代码与环境变量 不提供独立路径 不提供 必须填写精确 Model ID

模型家族和思考档位

价格页把同一模型家族的思考档位合并成一行,API 仍保留客户端可能需要的精确模型 ID。配置 Agent 时按下面的规则选模型:

  • Gemini 3.x 默认使用基础模型 ID,并在请求中传 reasoning_effort。-low、-medium、-high 后缀仍作为兼容 ID 接受,但不应把它们当成四个独立模型维护。
  • Antigravity 的 Argon low、medium、high 是上游原生档位。要保证 Argon 档位,使用 gemini-4-argon-low、gemini-4-argon-medium 或 gemini-4-argon-high;基础 Argon 名称可能按上游映射回退到 high。Flash 可以用基础模型加思考参数并读回实际档位。
  • Agent 配置文件中保存精确模型 ID;价格页的家族展示不会改变 API Key 的模型范围或路由。

每次切换模型或思考档位,都要启动一个新的 Agent 任务,并在 XiuAI“检查实际请求”中核对请求模型、协议、服务分组和成功状态。普通文本回复不能证明工具调用、编辑或长上下文已经可用。

Antigravity Agent 配置

  • Codex、OpenCode、Cline:使用 Responses 或 Chat Completions,模型填 gemini-3.8-flash 或 gemini-4-argon,再按客户端能力传 reasoning_effort。
  • Claude Code:使用 Messages,ANTHROPIC_BASE_URL=https://router-api.xiu.ai。
  • Gemini 原生图片、编辑和原生工具:使用 https://router-api.xiu.ai、x-goog-api-key 和 generationConfig;生图模型使用精确 ID gemini-3.1-flash-image。
  • 固定档位客户端:使用 gemini-4-argon-low、gemini-4-argon-medium 或 gemini-4-argon-high。

不要填写内部 /antigravity 路径。验收顺序是文本、流式、工具往返、可撤销编辑、图片;每一步核对模型、入口、分组、Token 和费用。

替换现有连接

先记录原 provider、Base URL、模型和凭据来源。然后只新增或修改 XiuAI 对应项,不删除原连接:

协议 Base URL 认证
OpenAI Chat Completions https://router-api.xiu.ai/v1 Authorization: Bearer
OpenAI Responses https://router-api.xiu.ai/v1 Authorization: Bearer
Anthropic Messages https://router-api.xiu.ai x-api-key;部分客户端使用 Bearer Token
Gemini GenerateContent https://router-api.xiu.ai x-goog-api-key 或 key 查询参数

把认证值换成你的 XiuAI API Key。目标模型 ID 在 XiuAI 中相同时,原模型配置可以保留;没有相同 ID 时,再改为当前目录中的精确模型 ID。

配置完成后必须新建会话或任务。已经运行的 Agent 进程通常保留启动时读取的环境变量、provider 和模型,不会因为配置文件被修改而自动切换。

对话协助的边界

ChatGPT 中的 Codex、OpenCode、Continue 和 OpenClaw 可以协助处理不含密钥的配置文件。其他客户端不显示该入口,因为它们依赖设置界面、父进程环境变量、服务端部署环境或会话外向导。

  • 当前 Agent 进程不能修改启动它的父进程环境变量。
  • API Key 不应进入模型上下文,也不应让 Agent 写入项目仓库。
  • Hermes 的 /model 只能切换已经配置的 provider,新增 Custom endpoint 必须退出会话后运行 hermes model。
  • Cline、DeepSeek Harness 和 Open WebUI 的凭据由设置界面保存,不是普通项目文件。
  • 有目标配置文件权限的 Agent 可以协助合并不含密钥的 TOML、JSON 或 YAML。是否能写用户目录取决于当前沙箱和权限;凭据、重载客户端和新建任务仍需你完成。

因此各指南只提供产品页列出的配置入口。不要把“Agent 已修改文件”当作连接已切换;客户端完成请求并在 XiuAI 控制台“检查实际请求”出现对应记录后,才算基础接入成功。

Cherry Studio、AionUI、DeepChat、Lobe Chat、OpenCat 等没有单独指南的客户端,如果当前版本提供 OpenAI Compatible、Anthropic Compatible、Gemini Compatible 或 Custom provider,也可以按对应协议配置。基础接入成功需要同时看到客户端完整回复和“检查实际请求”中的对应记录;专有工具调用、文件上传、托管搜索或特定 Responses 字段还需使用目标模型单独验证。

统一准备

  1. 按快速开始创建一把专用 API Key。
  2. 限制这把 Key 的模型、剩余额度和有效期。
  3. 只有客户端要求显式模型时,才从模型与价格复制精确模型 ID。
  4. 首次配置直接新增连接;替换已有时先保留原连接。
  5. 配置完成后新建一个小任务,并在“检查实际请求”核对请求。

不要复用生产项目的 Key 做试错。现有 Key 若带有 IP 限制,云端代发客户端可能因出口地址不同被拒绝;控制台当前不提供该限制的编辑入口。

怎么判断接入成功

同时满足以下三项才算接入成功:

  1. 客户端收到完整回复,而不是只通过“验证 Key”。
  2. XiuAI 控制台“检查实际请求”出现对应 Key、模型、接口和成功状态。
  3. 客户端需要的最小工具调用能正常完成。

一次普通文本回复不能证明 Agent 编辑、图片、文件、托管搜索或长上下文也可用。按真实任务逐项扩大验证范围。

怎么回滚

  • 保留客户端原来的 provider 或 Base URL。
  • 新配置失败时,先切回原 provider,不要反复改同一把 Key 的范围。
  • 删除测试 provider 前,先确认没有项目仍把它设为默认。
  • 测试 Key 不再使用时,在 XiuAI 撤销或删除。

来源与核对日期

内容核对于 2026-11-07。Antigravity 原生 Gemini、图片、工具和思考档位按当前生产请求验收;第三方客户端升级后,设置名称、配置文件和请求协议可能变化,请以客户端当前界面和官方文档为准。

导航

输入关键词开始搜索

↑↓ 移动↵ 打开Esc 关闭