接入指南
StarBridge 是 OpenAI 兼容的中转 API：不需要用我们的网页，在你自己的软件里填三项配置即可调用
三步上手
三项配置（所有软件通用）
http://127.0.0.1:8080/v1sk-...（你的 Key，控制台创建）kimi-k3当前在售模型：kimi-k3（Kimi 编码模型，支持流式输出 stream=true）。模型会陆续增加，完整列表见控制台「模型广场」。
常见软件怎么填
Cherry Studio
- 设置 → 模型服务 → 选择「OpenAI」（或添加 OpenAI 兼容提供商）
- API 地址填上方 Base URL，API 密钥填你的 sk- Key
- 「管理模型」添加模型
kimi-k3，保存后回到对话选择该模型
NextChat（ChatGPT-Next-Web）
- 设置 → 自定义接口：接口地址填 Base URL，API Key 填你的 sk- Key
- 自定义模型列表添加
kimi-k3并启用 - 对话页模型切换为 kimi-k3
沉浸式翻译 / 其他浏览器插件
- 设置 → 翻译服务 → 选择「OpenAI」或「自定义 AI 接口」
- API 地址填 Base URL，Key 填 sk- Key，模型填
kimi-k3
命令行 curl
curl http://127.0.0.1:8080/v1/chat/completions \
-H "Authorization: Bearer sk-你的Key" \
-H "Content-Type: application/json" \
-d '{"model":"kimi-k3","messages":[{"role":"user","content":"你好"}],"stream":false}'
Python（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="kimi-k3",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)
计费与倍率说明
按次计费
按每次调用实际消耗的 Token 计费，价格以控制台「模型广场」公示为准（元 / 百万 Token，输入输出分开计价）。
不足 1 分按 1 分收
有实际 Token 消耗但折算不足 1 分时，按 1 分保底收取；完全没有产生消耗不收费。
合租房间倍率
加入合租房间的调用按「售价 × 房间倍率」计费，倍率由房主设定、以房间页公示为准（折扣房间可低于官方价）。
消费明细可查
每笔扣费都会写入资金流水，在控制台「消费明细」可逐条核对（含变动后余额）；充值记录在「充值中心」。
调用报错了？
| 401 | Key 错误、已停用或已删除。核对是否完整复制（sk- 开头无空格），或到控制台「API Keys」确认状态。 |
| 403 | 余额不足。到控制台「充值中心」充值，或联系管理员调整余额。 |
| 429 | 触发限流（每个 Key 每分钟 60 次）。降低并发，稍等几秒再试。 |
| 超时 | 长回答建议开启流式（stream=true）；单次请求网关超时上限为 120 秒。 |
| 充值不到账 | 先到控制台「充值中心 → 充值记录」核对订单状态；扫码人工通道需管理员人工核对入账，付款后请联系管理员并提供订单号。 |
| 多模型 | 一个 API 密钥能不能用多个模型？可以。Key 默认不限模型（可调用全部在售模型）；创建时若绑定了模型则只能调该模型；合租房间另有房间自己的模型白名单。 |
| 失败扣费 | 调用失败扣费吗？不扣。请求失败（4xx 或全部渠道重试失败）不计费；流式中断按已送达部分计费，异常扣费会自动退回（消费明细中类型为「退款」）。 |