StarSeaAPI

常见问题

接口是否兼容 OpenAI？

兼容。所有文本模型都使用 OpenAI 线格式的 /v1/chat/completions 与 /v1/responses，含流式输出、工具调用与图片内容块。此外还原生终结 Anthropic Messages 与 Gemini 风格路径。

从 OpenAI 迁移需要改多少代码？

把 base_url 指向本站端点、替换 API Key 即可，请求与响应的处理逻辑无需改动。

计费方式是怎样的？

按量模型分别对输入与输出 token 计费，输出通常是输入的若干倍；图像模型按次计费。每个模型页都列出每百万 token 单价与输出倍率，定价表则把全目录并列展示。

缓存命中会更便宜吗？

会。重复的提示词前缀按折扣计费，因为上游保留了对应的 KV 缓存，无需重跑预填充。平台会把同一会话的请求路由到同一上游，从而使这项折扣真正生效。建议把稳定内容（系统提示词、参考文档）放在前面，易变内容放在后面。

上游出现故障时会怎样？

模型由多条相互独立的上游线路承载。命中故障线路的请求会自动改走其他线路；渠道错误率越过阈值时会被自动摘除，恢复后自动回归。

不支持视觉的模型也能处理图片吗？

可以。对纯文本模型，网关会先读图并把描述注入上下文，因此同一份请求体在整目录内都可用；原生多模态模型则直接接收原图，不做额外处理。

支持哪些支付方式？

支付宝与微信支付，支付后额度自动到账。账目以人民币计价，定价页同时给出美元参考值。

有免费额度吗？

没有。不设免费额度，也就不需要对付费流量施加激进限流。低价档模型的价格足以支撑在真实流量上做评估。

不登录如何查余额和用量？

使用密钥查询页：粘贴 API Key 即可查看余额与用量，查询走只读脱敏视图，并使用与主链路分离的限流通道。

能否一次性配置多个客户端？

可以。Windows 与 macOS 提供一键导入脚本，把模型清单直接写入受支持的 AI 编程客户端本地配置中，无需手工逐条填写模型 id。脚本一次性执行完毕后即退出，不注册任何后台任务。

模型 id 稳定吗？

id 沿用上游命名并保持稳定。带日期后缀的版本变体单独作为一个 id 列出，这样上游滚动更新不会在你不知情的情况下改变行为。

支持流式输出和长输出吗？

所有文本模型均支持流式输出。最大输出长度因模型而异，在模型页逐个标注；推理模型的思考 token 也计入该上限。

「原生多模态」与「桥接多模态」有什么区别？

原生指上游模型本身接受图片并直接读图，适合对细节敏感的任务；桥接指由平台完成图像理解后把文本传给下游模型，适合「用一个便宜模型处理全部请求」的场景。

一个密钥能用所有模型吗？

可以，单个密钥覆盖整个目录；需要下发更窄权限时，也可以按密钥限制额度与可用模型范围。