星桥 API 使用文档

快速开始

1. 登录星桥，在钱包确认可用余额。
2. 在模型价格先选模型类别，再选具体分组，确认模型名称、输入输出价格及支持的端点。
3. 打开 API 密钥，点击“创建 API 密钥”，填写名称，明确选择刚才查看的分组，再设置额度、有效期及模型限制。新密钥不选分组不能保存；首次使用建议先选具体分组。
4. 复制完整密钥，按下方地址与协议填写客户端，再完成一次最小请求。建议每个工具使用独立密钥，方便核对和停用。
5. 在使用日志对照请求时间、模型、实际分组和费用。能获取模型列表，只说明地址和鉴权通过，还需要完成一次生成请求。

客户端填写的是本站生成的 API 密钥，不是网站登录密码，也不是其他平台的密钥。分组决定请求可以走哪些渠道；仅填写模型名，不能绕过分组权限。

下文的 YOUR_MODEL_ID、YOUR_CLAUDE_MODEL_ID 和 替换为你的星桥密钥 都是占位符，必须替换后再使用。不要把密钥发到群聊、截图或提交到 Git 仓库。

分组怎么选

先按用途选，再比较价格

福利组、标准组、稳定组、Pro 是本站分组名称。不同组可用模型、上游线路、倍率和能力可能不同，名称本身不代表所有模型都可用，也不是成功率承诺。先在模型价格选择该组，再比较同一个模型的实际单价；遇到异常可查看分组状态。

Auto 是什么

Auto 按候选分组及其顺序选择可用线路。它不会自动开通所有模型，也不保证最低价格。请求最终按实际命中的分组计费，可在使用日志核对。

• 选择“全局 Auto”时，使用站点提供的候选分组顺序。
• 选择自定义顺序时，只在当前可选组中添加候选组，并确认这些组能调用目标模型。
• 页面提示“没有可用的全局 Auto 分组”或“没有可用的自定义 Auto 分组”时，不能直接保存；改选具体分组，或补充有效候选组。
• 有候选组仍可能遇到模型不支持、限流或上游故障。第一次接入先用具体分组完成测试，再配置 Auto。

这里的 Auto 是密钥路由分组，与 Cursor 等客户端的 Auto 模型选择是两件事。

“跟随账号分组”是什么意思

部分旧密钥显示“跟随账号分组”，表示使用账号当前所属组；账号分组调整后，它也会跟着变化。它不是一个可同时调用所有分组的选项。新建密钥必须主动选组；已有密钥可在编辑页面改为明确的具体组。

价格、倍率与缓存

看最终单价，不要重复乘倍率

在模型价格中选定分组后，模型价格已应用该分组的计价规则。分组按钮及模型详情中的倍率保留三位小数，方便比较；展示时的四舍五入不改变实际扣费精度。

不要把页面上的最终单价再乘一次分组倍率。同一模型也可能在不同分组使用不同定价，不能只靠两个倍率的比值推算费用。

缓存读取和缓存写入不同

缓存读取是本次复用了已有输入，缓存写入是本次创建可供后续复用的缓存。写入可能比普通输入贵，读取通常更便宜；各模型、分组的配置不同，不能统一套用官方倍率或其他站点的价格。

Claude 的 5 分钟写入和 1 小时写入可能分别计价。这里的“5 分钟 / 1 小时”是缓存写入后的可复用有效期或上游缓存窗口，不是请求耗时。核对费用时，应分开看普通输入、输出、缓存读取、5 分钟写入和 1 小时写入；同一批 Token 不要重复计入多个类别。不同协议的原始 input_tokens / prompt_tokens 是否包含缓存部分也有差异，优先看本站日志中的计费明细。实际是否命中，以日志里的缓存 Token 和计费明细为准，不要只按请求间隔手工推断。

对普通 Token 计费，可以按以下方式理解费用；动态计费、图片、音频和按次任务以对应规则为准：

费用 = 普通输入Token × 普通输入单价 / 1,000,000
     + 输出Token × 输出单价 / 1,000,000
     + 缓存读取Token × 读取单价 / 1,000,000
     + 各类缓存写入Token × 各自写入单价 / 1,000,000

以上各类 Token 指已按协议口径区分、没有重复计算的数量，单价均按每百万 Token 计算。例如，假设普通输入为 ¥1 / 1M、输出为 ¥5 / 1M，一次无缓存请求使用 10,000 输入和 2,000 输出 Token，费用就是 ¥0.01 + ¥0.01 = ¥0.02。这是算术示例，不是本站报价。

缓存由模型和上游决定，不是勾选一次就一定命中。新会话、提示内容变化、缓存过期或切换线路都可能改变命中情况；本站不承诺固定缓存命中率。

为什么费用比预期高

先确认 /1M 与 /1K、标准与充值视角、实际分组是否一致，再检查缓存写入、长上下文和客户端重试。Agent 完成一个任务时可能连续请求多次，不能把“一条聊天消息”当成一次 API 调用。

钱包与充值

1. 打开钱包，选择页面提供的金额档位，或填写符合最低充值要求的正整数金额。
2. 核对到账额度、优惠及实付金额，再选择当前可用的支付方式。可用渠道和优惠可能调整，以当前页面与订单为准。
3. 支付完成后回到钱包，检查余额和“订单记录”。关闭支付页不代表订单已成功。
4. 已支付但未到账时，先查看订单状态并刷新。保留订单号和支付时间，按网站首页 / 关于页面或站内公告公布的管理员联系方式反馈，避免重复付款。请同时提供金额和脱敏截图，不要发送 API Key。

如果持有兑换码，在钱包的兑换入口填写；兑换码不是 API 密钥。账户余额与密钥额度是两层限制：余额足够时，密钥也可能因为额度耗尽、过期或停用而无法调用。“无限额度”仅表示不单独限制该密钥额度，仍会消耗账户余额。

注册赠额、邀请奖励及活动优惠以账户实际记录和当前活动规则为准。不要仅凭其他用户的旧截图判断自己应到账多少。

地址与协议

这些是协议的实际请求路径，通常不要把完整路径填进 Base URL：

客户端会在 Base URL 后拼接路径。如果错误地址里出现 /v1/v1、/responses/responses，先检查是否重复填写。不要使用服务器 IP 代替域名，HTTPS 证书和网站分流均依赖域名。

最小请求与流式调用

以下命令适用于 macOS / Linux 终端。示例中的密钥仅是占位符，填写真实密钥时注意终端历史记录。

export XINGQIAO_API_KEY="替换为你的星桥密钥"
curl --fail-with-body "https://newapi.xingqiaoapi.cn/v1/models" \
  -H "Authorization: Bearer $XINGQIAO_API_KEY"

Windows PowerShell：

$env:XINGQIAO_API_KEY = "替换为你的星桥密钥"
Invoke-RestMethod -Uri "https://newapi.xingqiaoapi.cn/v1/models" `
  -Headers @{ Authorization = "Bearer $env:XINGQIAO_API_KEY" }

返回的 data[].id 可用于填写模型名。模型列表请求用于检查地址和鉴权；它成功不代表所有模型都能完成生成，也不证明工具调用可用。

选择一个支持 Chat Completions 的模型，进行一次小请求（会产生实际用量）：

curl --fail-with-body "https://newapi.xingqiaoapi.cn/v1/chat/completions" \
  -H "Authorization: Bearer $XINGQIAO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL_ID","messages":[{"role":"user","content":"只回复：连接成功"}]}'

完成后在使用日志确认模型、分组、时间和消耗。不要反复发送长请求来测试连接。

Responses 请求

Codex 使用的模型需要支持 Responses；请先在模型价格页检查端点，再替换模型 ID：

curl --fail-with-body "https://newapi.xingqiaoapi.cn/v1/responses" \
  -H "Authorization: Bearer $XINGQIAO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL_ID","input":"只回复：连接成功"}'

Anthropic Messages 请求

Claude Code 对应的模型应支持 Anthropic Messages：

curl --fail-with-body "https://newapi.xingqiaoapi.cn/v1/messages" \
  -H "Authorization: Bearer $XINGQIAO_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_CLAUDE_MODEL_ID","max_tokens":64,"messages":[{"role":"user","content":"只回复：连接成功"}]}'

验证流式输出

在已成功的 Chat Completions 请求中加入 "stream":true，并给 curl 添加 -N，关闭输出缓冲：

curl -N --fail-with-body "https://newapi.xingqiaoapi.cn/v1/chat/completions" \
  -H "Authorization: Bearer $XINGQIAO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL_ID","messages":[{"role":"user","content":"只回复：连接成功"}],"stream":true}'

流式返回是连续的 SSE 事件，不是一段完整 JSON。Chat Completions、Responses 和 Anthropic Messages 的事件结构不同，客户端需要使用对应协议的解析器。普通请求成功后，再分别验证流式和工具调用；发生中断时，记录最后收到的事件及错误，不要让程序无限重试。

Cursor

适用范围： 提供 Override OpenAI Base URL 设置、且请求格式与本站接口兼容的 Cursor 版本。这个入口并不等于 Cursor 全部功能都可使用第三方 API。

1. 打开 Cursor Settings → Models，找到 API Keys。界面名称可能随版本变化。
2. 在 OpenAI API Key 中填写星桥密钥，并启用对应开关。
3. 如果该版本提供 Override OpenAI Base URL，启用它，填写 https://newapi.xingqiaoapi.cn/v1。
4. 添加该密钥可用的完整模型 ID，然后在聊天面板选择该模型。不要用 Auto 模式来判断是否走了星桥。
5. 先发送一句短消息，再检查星桥使用日志是否出现对应请求。

需要知道的限制

• Cursor 官方说明：自定义密钥适用于聊天模型，Tab 补全仍使用 Cursor 自带模型，不是星桥 API 的功能。
• Agent、工具调用和推理模型兼容性需要分别验证。普通聊天成功，不代表所有 Agent 工作流都成功。
• 官方 BYOK 页面不承诺通用第三方网关全兼容。部分平台需要专门适配 Cursor 的请求格式；本站当前没有单独的 /v1/cursor 接口，不要照抄其他站点的专用路径。
• 没有自定义 Base URL 入口的版本，不能仅把星桥密钥填进官方 OpenAI 密钥框。可以先使用下方 Codex CLI 或 Cherry Studio。
• Cursor 官方说明其请求经过 Cursor 后端。若命令行测试正常但 Cursor 不通，还需要检查 Cursor 到网关的连通性与当前版本支持范围。
• 自带密钥不等于取消 Cursor 产品本身的账户、套餐或功能限制。

参考：Cursor 官方 BYOK 说明；OpenRouter 的 Cursor 适配说明。后者用于核对设置入口与专用接口差异，不能直接套用它的地址和模型 ID。

Codex CLI

协议要求：Responses。 所选模型和分组必须支持 /v1/responses；仅支持 Chat Completions 的渠道不适用于这份配置。

1. 设置密钥环境变量

macOS / Linux：

export XINGQIAO_API_KEY="替换为你的星桥密钥"

Windows PowerShell：

$env:XINGQIAO_API_KEY = "替换为你的星桥密钥"

这些设置只影响当前终端及其启动的程序。重新打开终端后需要重新设置，或使用你自己的安全凭据管理方式。

2. 合并用户级配置

编辑 ~/.codex/config.toml；Windows 通常为 %USERPROFILE%\.codex\config.toml。先备份已有文件，合并配置，不要直接覆盖其他设置。同名键和 [model_providers.xingqiao] 只保留一份。

model = "YOUR_MODEL_ID"
model_provider = "xingqiao"

[model_providers.xingqiao]
name = "星桥 API"
base_url = "https://newapi.xingqiaoapi.cn/v1"
env_key = "XINGQIAO_API_KEY"
wire_api = "responses"

把 YOUR_MODEL_ID 改成当前密钥可用且支持 Responses 的模型。不要仅根据别人的截图猜模型名。

3. 从同一个终端启动

codex

先在测试目录中让它回答一个简单问题，并在星桥使用日志核对消耗。若提示缺少 XINGQIAO_API_KEY，确认变量设置与启动 Codex 的终端是同一个。

桌面端和编辑器扩展

本文配置步骤以 Codex CLI 为准。不同桌面端与扩展版本的自定义提供商支持、配置读取方式可能不同；从 Dock 或开始菜单启动的程序也不一定继承终端环境变量。不要把 CLI 配置成功当作桌面端已经配置成功。先按对应版本官方说明确认支持范围。

提供商配置应放在用户级文件；当前官方文档说明项目级 .codex/config.toml 不允许覆盖提供商和凭据路由相关配置。此配置不会把星桥密钥变成 ChatGPT 订阅登录，也无需覆盖已有登录文件。

参考：OpenAI 官方 Codex 高级配置。

Claude Code

协议要求：Anthropic Messages。 请使用支持该协议、并满足 Claude Code 工具调用需求的 Claude 模型与分组。

1. 配置当前终端

macOS / Linux：

export ANTHROPIC_BASE_URL="https://newapi.xingqiaoapi.cn"
export ANTHROPIC_AUTH_TOKEN="替换为你的星桥密钥"
export ANTHROPIC_MODEL="YOUR_CLAUDE_MODEL_ID"
claude

Windows PowerShell：

$env:ANTHROPIC_BASE_URL = "https://newapi.xingqiaoapi.cn"
$env:ANTHROPIC_AUTH_TOKEN = "替换为你的星桥密钥"
$env:ANTHROPIC_MODEL = "YOUR_CLAUDE_MODEL_ID"
claude

这里的 Base URL 不带 /v1。认证使用 Authorization: Bearer，不要混用其他账号遗留的网关地址或密钥。

2. 确认实际连接

在 Claude Code 中运行 /status，核对 Anthropic base URL 与 Auth token 来源，发送一句短消息，再核对星桥使用日志。某些后台或辅助任务还会请求额外模型；如果它们报模型不可用，需要确认该分组是否提供相应模型，不要只检查主模型。

3. 需要持久保存时

可以把下面的 env 字段合并到用户级 ~/.claude/settings.json；Windows 通常为 %USERPROFILE%\.claude\settings.json。不要删除原有配置，也不要把包含真实密钥的文件提交到项目仓库。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://newapi.xingqiaoapi.cn",
    "ANTHROPIC_AUTH_TOKEN": "替换为你的星桥密钥",
    "ANTHROPIC_MODEL": "YOUR_CLAUDE_MODEL_ID"
  }
}

官方文档说明 settings 文件中的 env 可覆盖同名 shell 变量。如果改了终端变量仍连接旧站，检查已有 settings 文件，并以 /status 的实际结果为准。

当前兼容性说明

本站代码提供 /v1/messages，但未启用 /v1/messages/count_tokens。若某个版本或功能依赖该端点，可能出现 404。这不应通过乱改密钥或重复添加 /v1 解决，请提供工具版本和报错路径给管理员。还没有完成所有 Claude Code 功能的逐项实测。

参考：Anthropic 官方网关接入教程。

Cherry Studio

新版 Cherry Studio 已内置 New API 服务商，建议优先使用这个入口。

1. 打开 设置 → 模型服务 → New API。
2. 在 API 密钥中填写星桥密钥。
3. 在 API 地址中填写根地址：https://newapi.xingqiaoapi.cn。
4. 获取模型列表，或手动添加该分组支持的模型 ID；完成检测后启用服务商。
5. 新建对话，明确选择这个服务商下的模型，发送短消息，并检查星桥使用日志。

New API 服务商会按协议自动添加 /v1 或 /v1beta，不需要把 /chat/completions 粘贴进地址。普通配置也不需要在地址末尾添加 #。

如果你的版本没有 New API 服务商：使用“添加服务商 / 自定义服务商”，选择与模型对应的 OpenAI 或 Anthropic 协议。不同版本对“API 地址”和“完整端点”的含义不同，应检查界面展示的最终请求路径，确保它只出现一次 /v1。升级或切换服务商前保留现有配置。

如果以前使用过测试版，检查各协议的地址中是否残留 localhost 或旧服务商地址。获取模型列表失败与某个模型的对话失败是两类问题，应分别记录错误。

参考：Cherry Studio 官方 New API 配置；自定义服务商说明。

OpenClaw

通过自定义 models.providers 接入。下面的示例使用 OpenAI Chat Completions，适用于支持该协议及工具调用的模型；不要把仅支持 Responses 的模型直接套入这个示例。

1. 在启动 OpenClaw 的运行环境中设置 XINGQIAO_API_KEY。若由系统服务或容器启动，变量必须进入对应服务或容器，仅在个人终端里 export 不够。
2. 在 OpenClaw 配置中合并下面的片段。保留已有的消息渠道、网关和其他提供商设置。
3. 两处 YOUR_MODEL_ID 必须替换为同一个实际模型 ID。

{
  "agents": {
    "defaults": {
      "model": { "primary": "xingqiao/YOUR_MODEL_ID" }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "xingqiao": {
        "baseUrl": "https://newapi.xingqiaoapi.cn/v1",
        "apiKey": "${XINGQIAO_API_KEY}",
        "api": "openai-completions",
        "models": [
          { "id": "YOUR_MODEL_ID", "name": "星桥模型" }
        ]
      }
    }
  }
}

按你的安装方式重新加载配置，然后执行：

openclaw models list

确认列表中有 xingqiao/你的模型ID，再进行一轮简单对话并检查星桥使用日志。OpenClaw 中的 xingqiao/ 是提供商前缀；models 数组里的 id 则是站点实际模型名，不要无意中重复添加前缀。

图片、推理和工具调用能力需要与真实渠道一致。不要从其他站点照抄上下文长度、能力标记、零成本配置或私有模型名。

参考：OpenClaw 官方自定义提供商说明。

CC Switch：导入星桥配置

CC Switch 用于管理和切换 Claude Code、Codex 等工具的服务商配置。它不是 API 服务，也不会自动提供密钥、余额或模型权限。请先从 CC Switch 官方项目安装适合系统的版本，并在星桥创建 API 密钥。

方法一：点击链接导入地址模板

下面两个链接包含服务商名称、地址、官网及密钥占位值 REPLACE_WITH_YOUR_XINGQIAO_API_KEY，不包含真实密钥，默认不启用，也不指定模型。CC Switch 导入时要求密钥字段非空；导入后必须编辑占位值。无需在这个文档页面输入密钥。

• 导入星桥 · Claude Code
• 导入星桥 · Codex

1. 在安装了 CC Switch 的电脑上，用系统浏览器打开本页并点击对应入口。
2. 浏览器询问是否打开 CC Switch 时，选择打开。在 CC Switch 的导入预览中核对名称和地址，再确认导入。
3. 找到新建的星桥服务商，点击“编辑”，把 REPLACE_WITH_YOUR_XINGQIAO_API_KEY 替换成自己的星桥 API Key。占位值不能用于调用，不要直接启用未编辑的模板。
4. 获取模型列表，或手动填写该密钥分组支持的完整模型 ID。不要把教程中的 YOUR_MODEL_ID 当成真实模型。
5. 保存后，在对应应用页点击“启用 / 使用”，再启动或重启相应 CLI 工具，并发送一条短消息。
6. 到星桥使用日志确认请求确实使用了正确的模型与分组。

导入与启用是两个步骤。没有填写密钥、选择可用模型之前，地址模板本身不能发起正常对话。不同 CC Switch 版本的字段名称和导入校验可能不同。

方法二：在 CC Switch 中手动添加

如果浏览器没有唤起应用，或者你的版本不支持上述导入方式，可以手动添加，地址相同。

1. 打开 CC Switch，在顶部切换到 Claude Code 或 Codex 应用。
2. 点击右上角 + / 添加服务商，选择应用专属服务商中的 自定义 / Custom，不要选官方订阅登录或 Codex OAuth 反代。
3. 按下表填写，保存后再启用。

Claude Code： 自定义配置使用 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN（或者该版本表单生成的 ANTHROPIC_API_KEY）；不要同时保留两套不同服务商的认证值。地址不带 /v1。本页 Claude Code 章节中的模型、辅助请求及 count_tokens 限制同样适用。

Codex： 选择原生 Responses 配置，确认生成的 base_url 是上表地址、wire_api 是 responses，提供商 ID 与 model_provider 一致。让 CC Switch 的表单管理它生成的鉴权配置；不要把本页 Codex CLI 的环境变量方案与另一套 auth.json 配置随意混合。单纯接入本站原生 Responses 不需要为了导入而启用本地协议转换。

如果所选模型只有 Chat Completions，不能仅改标签就认为它支持 Responses。CC Switch 的本地路由 / 协议转换属于另一种接入方式，需要独立测试，本文不把它作为默认方案。

已经手动配置过，怎么迁入？

CC Switch 官方说明首次启动时可把现有 CLI 配置导入为默认服务商。如果你已按上面的 Codex / Claude Code 教程配置过，可以使用这个首次导入入口，并检查导入后的密钥来源、地址和模型；已经使用 CC Switch 的用户可直接新建星桥服务商，不必清空原有配置。

不要用“数据库备份导入”来代替添加一个服务商。 .sql 备份恢复会覆盖现有 CC Switch 数据库，和本页的单服务商地址模板导入不同。切换前保留原来的服务商，便于恢复。

导入后不生效怎么办？

• 点击没反应： 确认已安装并启动过 CC Switch。微信等应用内浏览器可能不支持 ccswitch://，复制本页网址到电脑系统浏览器，或直接使用手动方法。
• 仍请求旧站： 检查是否启用了正确应用下的星桥服务商；终端环境变量、共享配置片段和项目设置可能与新配置冲突。Claude Code 可用 /status 查看实际地址和认证来源。
• 提示缺少密钥： 本页导入链接只包含占位值，请在 CC Switch 内填写真实密钥，并确认没有遗留未设置的环境变量引用。
• 模型不可用： Claude 和 Codex 的模型与协议不能互换，重新核对密钥分组及模型 ID。
• 配置生效范围： 优先重开对应 CLI 会话。不要据此认为 Codex 桌面端、Claude Desktop 或所有编辑器扩展也自动完成了配置。

参考：CC Switch 官方服务商管理、深链接导入协议。本文已核对协议字段，未在你的 CC Switch 中实际导入或切换现有配置。

图片生成与下载

在模型价格选择图片分组，确认模型支持 Images 接口，再为该组创建密钥。先在发起请求的终端设置密钥；以下是最小生成示例，会产生实际费用，模型名与可用参数以该模型说明为准：

export XINGQIAO_API_KEY="替换为你的星桥密钥"

curl --fail-with-body "https://newapi.xingqiaoapi.cn/v1/images/generations" \
  -H "Authorization: Bearer $XINGQIAO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_IMAGE_MODEL_ID","prompt":"一只蓝色陶瓷杯，白色背景，产品摄影","n":1}'

在哪里下载

1. 等待生成完成，登录发起调用的同一个星桥账号。
2. 打开侧边栏的图片记录，找到对应模型、分组和生成时间。
3. 点击预览图标查看大图，点击下载图标保存原图。图片加载完成前，下载按钮不可用。

图片记录与 API 使用日志是两个入口：图片记录用于预览、下载；使用日志用于核对用量、费用和请求信息。图片记录按账号隔离，目前保留 7 天，请及时下载到本地。

当前图片记录覆盖已接入的 Images 生成 / 编辑响应。通过其他协议、聊天附件或 Responses 工具返回的图片，不保证都会出现在这里；功能上线前的历史图片也不会自动补齐。无论是否出现记录，客户端都应保存成功响应中的图片或地址。

有调用记录却看不到图片

先核对账号、时间和模型，等待生成结束后刷新图片记录。请求报错、没有返回可识别图片、原始图片地址失效，或记录已超过保留期，都可能导致无法预览或下载。此时保留请求 ID 和脱敏错误联系管理员，重新生成会产生新的请求和可能的费用。

使用日志与费用核对

打开使用日志，按调用时间、模型或密钥等页面提供的筛选项查找记录，再打开详情。

网关可能先预扣额度，再按实际结果结算；遇到余额变化应结合最终调用记录核对。客户端显示失败，也可能已经收到了部分输出或发生重试，不能仅凭界面报错判断没有用量。费用有疑问时，提供具体记录，不要用当前报价去直接重算全部历史账单。

模型列表、鉴权或网络阶段就失败的请求，不一定产生消耗记录。没有使用日志时，仍要检查错误响应、客户端实际地址和网络连接。

分组状态

分组状态是公开页面，可以查看分组当前状态、最近 24 小时的状态条及请求成功率。页面约每 30 秒刷新一次，可按分组名称搜索。

• 绿色：当前统计状态正常。
• 黄色：当前统计存在降级。
• 红色：当前统计存在中断。

没有调用样本的分组按绿色、100% 显示，这表示暂未记录到失败，不是主动探测已验证成功，也不是所有模型都保证可用。将鼠标移到状态条或用键盘聚焦，可以查看对应时段是否有请求。

视频分组暂不纳入该公开状态页；图片分组只展示已确认纳入的组。状态正常但你的请求失败时，仍应核对具体模型、协议、密钥和错误正文。

常见问题

Agent 一直调用工具，或使用了错误系统的命令

先记录工具名、完整报错、客户端版本、操作系统及所选模型。模型生成的命令由客户端工具执行，命令与操作系统不匹配、工具参数不兼容或重复重试，都需要结合实际请求排查。用同一密钥与模型完成最小请求，再单独验证工具调用；聊天成功不能证明 Agent 的整条工具链正常。

如果中间还接了其他网关，在星桥日志中先确认请求是否到达，再逐层核对协议与错误。请勿把其他平台专用的路径或模型别名直接套到本站。

为什么换服务器后仍有人连到旧 IP？

域名迁移后，运营商、路由器、系统、浏览器或代理软件都可能缓存旧解析。重启浏览器、刷新代理 DNS 缓存或切换网络有助于排查，但不是所有连接重置都由 DNS 导致。不要因为别人能打开就认定自己的密钥错误，也不要关闭证书校验。

怎么确认确实用了星桥？

客户端显示连接成功后，在星桥使用日志中对照请求时间、模型、分组和用量。如果没有记录，还应检查客户端是否仍选择 Auto、内置模型或其他提供商。连接在鉴权或网络阶段失败时，也可能尚未产生用量日志。

联系管理员时提供什么？

提供工具名称与版本、操作系统、所选模型和分组、报错时间、脱敏后的完整错误信息，以及 Wi-Fi / 流量测试结果。截图中遮住 API Key，不要发送完整密钥。不要把有密钥的配置直接粘贴到公开 Issue。支付或图片记录问题还应附订单号 / 请求 ID；联系方式以首页、关于页面或站内公告当时公布的入口为准。

来源与更新

本页为星桥针对自身 API 编写的接入说明，不是各工具的官方文档。以下公开资料用于核对配置项与能力范围；版本更新后以工具的最新官方说明和本站实测结果为准。

文档组织参考了以下 GitHub 中转站项目的密钥、接入示例、计费和排错说明。本站的分组、价格、支付方式和开放功能按自身实现编写，其他项目的配置和优惠不适用于本站。

• CC Switch：官方用户手册
• Cursor：Bring your own API key
• OpenAI：Codex Advanced Configuration
• Anthropic：Connect Claude Code to an LLM gateway
• Cherry Studio：New API
• Cherry Studio：自定义服务商
• OpenClaw：Custom providers and local runtimes
• OpenRouter：Cursor integration

本站基于 QuantumNous / new-api 开源项目构建。感谢原项目及工具文档维护者。