接入指南 - StarBridge

1注册登录

打开注册页，填写邮箱和密码，提交即注册成功（无需邀请码）。
用刚注册的邮箱登录，会自动进入控制台（网址 /console/dashboard.html）。
忘记密码或账号异常，到控制台「联系官方」提交反馈，管理员会处理。

2充值（人工充值）

第一步：转账

控制台 →「充值中心」，页面会展示管理员的支付宝收款码 / 收款账号，用支付宝转账，金额随意。

第二步：提交交易号

转账后回到「充值中心 → 人工充值」，填入转账金额和支付宝交易号（转账详情页可查，10~64 位字母数字），提交。

第三步：等到账

管理员人工核对收款后入账，一般 24 小时内到账。进度可在「充值中心 → 充值记录」查看（待审核 / 已入账）。

注意：转账金额必须与提交的金额一致，交易号不要填错，否则无法核对入账。有疑问到控制台「联系官方」反馈。

3创建密钥（API Key）

控制台 →「API Keys」→ 右上角「创建密钥」。
填一个名称（随便起，方便自己认），其余板块都可以留空 / 保持默认，点「创建」。
创建成功后页面会弹出完整 Key（sk- 开头），只显示这一次，请立即复制保存。

创建时的可选板块

绑定模型：默认「不限制」= 全部在售模型都能调；绑定后这个 Key 只能调指定模型。
额度限制：这个 Key 最多能花多少钱（元），0 或留空 = 不限。
有效期：填天数，到期后 Key 自动失效（调用返回 401）；0 或留空 = 永久有效。
速率限制：这个 Key 每分钟最多调用几次；0 或留空 = 跟随平台默认（60 次/分钟）。
IP 白名单：只允许指定 IP 使用这个 Key，多个用逗号分隔，支持 CIDR（如 1.2.3.4, 10.0.0.0/8）；留空 = 不限。

以上板块目前只能在创建时设置，创建后只能改名、停用、删除；需要调整就新建一个 Key。

4在你的软件里配置（三项）

StarBridge 是 OpenAI 兼容接口，任何支持「自定义 OpenAI / OpenAI 兼容」的软件都能用，只需要填三项。充值后无需加入任何房间，Key 即可直接调用全部在售模型。

Base URLhttp://127.0.0.1:8080/v1

API Keysk-...（第 ③ 步创建的 Key）

模型名到控制台「广场」复制在售模型名

快捷方式：控制台「API Keys」列表里点 Key 右侧的 🚀「使用密钥」按钮，会按你的 Key 自动生成下面的全部配置，直接复制粘贴即可。

常见软件怎么填

Cherry Studio（桌面聊天软件，推荐小白）

设置 → 模型服务 → 添加一个「OpenAI 兼容」提供商
API 地址填上方 Base URL，API 密钥填你的 sk- Key
点「管理」添加模型（模型名到「广场」复制），保存后回对话页选择该模型

Codex CLI（OpenAI 命令行编程工具）

把下面内容加入配置文件（macOS / Linux：~/.codex/config.toml，Windows：%USERPROFILE%\.codex\config.toml）：

model_provider = "starbridge"
model = "你的模型名"

[model_providers.starbridge]
name = "StarBridge"
base_url = "http://127.0.0.1:8080/v1"
wire_api = "chat"
env_key = "STARBRIDGE_API_KEY"

再设置环境变量后重启终端：

# macOS / Linux
export STARBRIDGE_API_KEY="sk-你的Key"
# Windows（PowerShell / CMD 均可，setx 后需重开终端）
setx STARBRIDGE_API_KEY "sk-你的Key"

Claude Code

Claude Code 原生使用 Anthropic 协议，本平台是 OpenAI 兼容协议，需经 claude-code-router 等适配层接入。适配层需要的环境变量：

# macOS / Linux
export ANTHROPIC_BASE_URL="http://127.0.0.1:8080/v1"
export ANTHROPIC_AUTH_TOKEN="sk-你的Key"
export ANTHROPIC_MODEL="你的模型名"
# Windows
setx ANTHROPIC_BASE_URL "http://127.0.0.1:8080/v1"
setx ANTHROPIC_AUTH_TOKEN "sk-你的Key"
setx ANTHROPIC_MODEL "你的模型名"

沉浸式翻译 / NextChat / 其他浏览器插件

找到设置的「自定义 OpenAI 接口 / OpenAI 兼容」入口
接口地址填 Base URL，Key 填 sk- Key，模型名到「广场」复制

命令行 curl / Python 代码

curl http://127.0.0.1:8080/v1/chat/completions \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{"model":"你的模型名","messages":[{"role":"user","content":"你好"}]}'

# pip install openai
from openai import OpenAI

client = OpenAI(
    base_url="http://127.0.0.1:8080/v1",
    api_key="sk-你的Key",
)
resp = client.chat.completions.create(
    model="你的模型名",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

5合租房间（可选，用别人的现成账号）

加房间不是必须的：不加入也能直接调用全部在售模型。房间适合想走指定专线 / 按房间公示规则计费的用户。

控制台 →「广场」，上方切到「账号广场」，能看到管理员发布的合租房间（房间名、平台、小时费、倍率都有公示）。
点「加入」，选择用你的哪个 Key 加入，即加入成功。
加入后像平常一样调用即可，请求会自动走房间的共享账号；计费按「售价 × 房间倍率」，以房间页公示为准。
控制台 →「我的合租」可查看已加入的房间和退出。

6视频 / 图片生成

控制台 →「媒体生成」，无需配置 Key，登录即可用（费用从余额扣）。
视频：输入提示词，可选清晰度、画面比例、时长，还可以上传首帧 / 尾帧图片控制画面；提交后等待生成，在页面下方查看结果。
图片：输入提示词提交即可。
可用模型以「媒体生成」页下拉列表为准，未上架的模型不会显示。

7常见问题

401	Key 错误、已停用、已删除或已过有效期。核对是否完整复制（sk- 开头无空格），到控制台「API Keys」确认状态和有效期。
403 余额	余额不足。到控制台「充值中心」按第 ② 步人工充值。
403 IP	提示「不在白名单」：这个 Key 设了 IP 白名单，你当前的出口 IP 不在里面。换网络环境，或新建一个不限制 IP 的 Key。
429	触发限流。平台默认每个 Key 每分钟 60 次（创建 Key 时可自定义）。降低并发，稍等几秒再试。
无可用渠道	提示「该模型暂无可用渠道」：该模型已下架或上游维护中。换「广场」里的其他在售模型，或到「联系官方」反馈。
超时	长回答建议开启流式（stream=true）；单次请求网关超时上限为 120 秒。
充值不到账	人工充值需管理员核对收款后入账，一般 24 小时内。超过时间未到：到「充值中心 → 充值记录」核对金额和交易号是否填对，再到「联系官方」反馈。
多模型	一个 Key 能不能用多个模型？可以。Key 默认不限模型（可调用全部在售模型）；创建时若绑定了模型则只能调该模型；合租房间另有房间自己的模型白名单。
失败扣费	调用失败扣费吗？不扣。请求失败（4xx 或全部渠道重试失败）不计费；流式中断按已送达部分计费，异常扣费会自动退回（消费明细中类型为「退款」）。
查消费	每笔扣费都写入资金流水：控制台「消费明细」逐条核对（含变动后余额），「用量」页看汇总，免登录的「用量查询」页可按 Key 查。

新手教程