开发者文档
StarHub Ai 同时提供 OpenAI 兼容(/v1/chat/completions)与 Anthropic 兼容(/v1/messages)双协议端点。已有 SDK 的项目只需修改 base_url 与 api_key。
认证方式
所有 /v1/* 接口使用 sk- 密钥认证,密钥在控制台「API Keys」创建,明文仅创建时展示一次。业务接口 /api/* 使用 JWT(有效期 2 小时,refresh 7 天)。
Authorization: Bearer sk-nb-xxxxxxxxxxxxxxxx模型 & 价格
价格单位为 元 / 1M tokens,输入输出分开计价。实时全量价目见 模型市场 或 GET /api/public/models。
deepseek-flash3.2412.961024Kqwen3.8-max-09021854977Kqwen3.8-omni-flash1.625.076977Kglm-5.312421024Kglm-5.3-flash1.24.21024Kglm-5.3-flashx310.51024Kglm-5-turbo7.5331024Kkimi-k2.7-code-highspeed19.581256KMiniMax-M33.1512.61024KMiniMax-M2.73.1512.6200KMiniMax-M2.7-highspeed6.325.2200KMiniMax-M2.5-highspeed6.325.2200KMiniMax-M2.1-highspeed6.325.2200KMiniMax-M23.1512.6200Kernie-5.1627125Kernie-5.0936116Kernie-x1.11.5664Kernie-4.5-turbo-128k1.24.8135Kagnes-3.0-flash免费0.5132Kernie-4.5-turbo-vl4.513.5139Kagnes-image-2.0-flash免费¥0.3/次—0qianfan-ocr0.6752.760Kdoubao-seedream-5-0-pro-260628按次¥0.45/次—0agnes-image-2.5-flash免费¥0.4/次—0doubao-seed-2-1-pro-2609159451024Kdoubao-seedream-5-0-flash-260915按次¥0.18/次—0doubao-seed-2-1-pro-260628945256Kdoubao-seedream-5-0-260128按次¥0.33/次—0doubao-seed-2-1-turbo-2606284.522.5256Kdoubao-seedream-4-0-20260415按次¥0.3/次—0doubao-seed-2-1-lite-2609151.24.051024Kdoubao-seed-character-2606281.23128Kwan3.0-video按次¥9.18/次—0claude-fable-5-1108540977Kgpt-6-astra1085401025Kclaude-fable-5108540128Kgpt-5.554324128Kgpt-image-2-4K按次¥2.16/次—128Kclaude-opus-554270128Kgpt-5.6-sol-az43.2216977Kgpt-image-2-adobe按次¥0.54/次—128Kgpt-5.6-sol43.2216977Kgpt-image-2-sp按次¥2.16/次—128Kclaude-opus-4-854270128Kclaude-opus-4-754270128Kgrok-4.721.664.8488Kgemini-3.5-flash16.297.2128Kgemini-3.8-flash8.140.5977Kgemini-3.7-flash8.140.5128Kgemini-3.5-flash-lite3.2427128Kgemini-3.6-flash8.140.5128Kgemini-2.5-flash-image按次¥0.4212/次—128Kgpt-5.6-terra-az21.6129.61025Kgpt-5.6-luna-az2.1612.96128Kgpt-5.6-terra21.6129.61025Kgpt-5.6-luna2.1612.96128Kgpt-5.4-pro3241944977Kgpt-5.4-nano2.1613.5128Kgpt-5.4-mini8.148.6128Kgpt-5.427162977Kgemini-flash-lite-latest1.084.32128Kgemini-3.1-flash-lite2.716.2128Kgemini-3.1-flash-lite-preview2.716.2977Kgemini-3.1-pro-preview-customtools21.6129.6128Kgemini-3.1-pro-preview21.6129.6128Kgemini-3-flash-preview5.432.4128Kgpt-5.3-codex18.9151.2128Kgpt-5.218.9151.2128Kgpt-5.113.5108128Kgemini-2.5-flash-image-preview按次¥0.432/次—128Kgpt-5-mini2.721.6128Kgpt-5-nano0.544.32128Kgpt-513.5108128Kgemini-flash-latest3.2427128Kgemini-2.5-pro13.5108128Kgemini-2.5-flash-lite1.084.32977Kgemini-2.5-flash3.2427128Ko4-mini11.8847.52128Kgpt-4.121.686.4128Kgpt-4.1-mini4.3217.28128Kgpt-4o-mini1.626.48128Kgpt-4o27108128Ko321.686.4128Kgrok-4.621.664.8488Kgrok-imagine-image-2.0按次¥0.864/次—128Kgrok-4.521.664.8128Kclaude-sonnet-521.6108128Kclaude-opus-4-6-thinking54270128Kclaude-sonnet-4-632.4162128Kclaude-opus-4-654270128Kclaude-haiku-4-5-20251001-thinking10.854128Kclaude-opus-4-5-2025110154270128Kclaude-haiku-4-5-2025100110.854128Kclaude-sonnet-4-5-2025092932.4162128Ktext-embedding-3-small0.2160128Kgpt-3.5-turbo-16k32.464.8128Kgpt-3.5-turbo-01255.416.2128Kgpt-oss-120b1.626.48128Kgrok-4.313.527128Kgrok-4.20-0309-non-reasoning13.527128Kgrok-4.20-0309-reasoning13.527128Kflux-2-pro按次¥0.324/次—128Kflux-2-max按次¥0.756/次—128Kimagen-4.0-generate-001按次¥0.648/次—128Kflux-kontext-max按次¥0.864/次—128Kgrok-imagine-image按次¥0.216/次—128Kflux-kontext-pro按次¥0.432/次—128Kflux-pro-1.1按次¥0.432/次—128Ktext-embedding-3-large1.4040128Kgpt-6-luna1.085.4128Kgpt-6-sol21.6108128Kclaude-opus-5-543.2216128Ko1162648128Kagnes-video-2.5按次¥2.125/次—0deepseek-v4-pro14.25642.7681024Kgpt-image-2.5-sunburst按次¥0.668/次—128Kgpt-image-2.5-flare按次¥0.0648/次—128Kgpt-5.2-codex18.9151.2128Kgpt-6.1-sol21.61081025Ktext-embedding-ada-0021.080128Kclaude-sonnet-5-521.6108977Kclaude-haiku-5-51.085.4977Kgpt-5.3-chat18.9151.2128Kqwen3.8-flash1.24.05977Kkimi-k3301501024Kqwen3.8-27b5.432.4977Kqwen3.8-2.4t-a95b21.664.8977Kqwen3.8-max1854977Kqwen3.7-flash0.31.2977Kqwen3.7-text-embedding0.750128Kglm-5.212421024Kkimi-k2.7-code9.7540.5256Kqwen3.5-ocr0.75364Kqwen3.7-plus312977Kqwen3.7-max927977Kkimi-k2.69.7540.5256Kqwen3.6-flash1.810.8977Kglm-5.19361024Kqwen3.6-plus318977Kqwen3-asr-flash-2026-02-1013.204Kglm-56271024KMiniMax-M2.53.1512.6200Kglm-4.7312200KMiniMax-M2.13.1512.6200K内部计量单位为配额点(quota):1 元 = 500,000 quota,所有扣费以整数 quota 进行,无浮点误差。响应头 X-Consumed-Quota 返回本次实际扣费。
上游渠道与转发说明
平台自建直连渠道与聚合渠道并存,模型列表中的每个模型均标注其厂商;渠道归属以响应头 X-Actual-Model 与调用详情页的上游渠道为准。已接入的海外模型上游形态如下:
- OpenAI(GPT 系列 / o 系列 / Embedding):OpenAI 官方第一方 API 直连(响应头携带官方组织与项目标识)。
- Anthropic(Claude 系列):Anthropic 官方模型,经 AWS Bedrock 官方托管通道提供(响应 id 前缀
msg_bdrk_)。 - Google(Gemini 系列):Google Gemini 官方 API(响应头
x-gemini-service-tier)。 - xAI(Grok 系列):xAI 官方第一方 API 直连(响应携带
cost_in_usd_ticks官方计费字段)。 - FLUX 系列(图像):经第三方聚合通道(rix-api)转发至 FLUX 官方接口,非 Black Forest Labs 直连,生成结果由该通道自有对象存储分发;如需 BFL 直连能力请另行申请。
同厂商不同模型可能落在不同上游通道,遇到个别模型异常时可切换同族模型重试;渠道级故障由平台自动降级,无需更换 Key。
Token 用量计算
计费公式
按 token 计费(整数运算,向上取整):
扣费 = ceil( (输入tokens × 输入单价 + 输出tokens × 输出单价) × 分组倍率 ÷ 1M )
示例:deepseek-chat(输入 ¥3/1M,输出 ¥12/1M,倍率 1.0)
一次 500 输入 + 800 输出 的对话:
= 500×3/1M + 800×12/1M
= ¥0.0015 + ¥0.0096 = ¥0.0111(= 5,550 quota)预扣-结算两段式
请求进入时按「估算输入 + max_tokens 上限」预扣冻结额度;请求完成后按上游返回的真实 usage 结算,多退少补。余额不足预扣时直接返回 402,并发请求不会透支。
流式请求的用量
非流式:usage 在响应体 usage 字段。流式:建议传 stream_options.include_usage: true,末块携带 usage;未携带时平台按本地估算×校正系数兜底。客户端中途断开也会按已产生 token 正常结算,不会丢账。
按次计费模型
图像/视频类模型按次计费(times_price),任务受理时预扣,异步任务失败自动全额退还。
对话 API
端点 POST /v1/chat/completions(OpenAI 兼容)与 POST /v1/messages(Anthropic 兼容)。三种语言示例:
curl
curl https://api.starhubc.com/v1/chat/completions \
-H "Authorization: Bearer sk-nb-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-chat",
"messages": [{"role": "user", "content": "你好"}],
"max_tokens": 1024,
"stream": false
}'Python(openai SDK)
from openai import OpenAI
client = OpenAI(
api_key="sk-nb-你的密钥",
base_url="https://api.starhubc.com/v1"
)
resp = client.chat.completions.create(
model="deepseek-chat",
messages=[{"role": "user", "content": "你好"}],
stream=True,
)
for chunk in resp:
print(chunk.choices[0].delta.content or "", end="")Node.js
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "sk-nb-你的密钥",
baseURL: "https://api.starhubc.com/v1",
});
const resp = await client.chat.completions.create({
model: "deepseek-chat",
messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);Anthropic 协议(/v1/messages)
curl https://api.starhubc.com/v1/messages \
-H "Authorization: Bearer sk-nb-你的密钥" \
-H "Content-Type: application/json" \
-H "anthropic-version: 2023-06-01" \
-d '{
"model": "deepseek-chat",
"max_tokens": 1024,
"system": "你是简洁的助手",
"messages": [{"role": "user", "content": "你好"}],
"stream": true
}'
# 流式返回 Anthropic 事件序列:
# message_start → content_block_delta... → message_delta → message_stop接口一览
/v1/models当前 Key 可用模型列表/v1/chat/completions对话补全(OpenAI 兼容,SSE 流式)/v1/messages对话(Anthropic 兼容,事件流式)/v1/embeddings文本向量化(按 token 计费)/v1/images/generations图像生成(按次计费)/v1/audio/speech语音合成(按次计费)/v1/audio/transcriptions语音转写(multipart,按 token)/v1/videos/generations视频生成(异步任务,按次计费)/v1/dashboard/billing/usage消耗查询(兼容第三方客户端)/api/public/auth/register注册(送 1,000,000 配额)/api/public/auth/login登录(JWT access + refresh)/api/user/wallet钱包余额查询/api/user/tokens签发 API Key/api/user/logs调用日志(游标分页)/api/user/orders创建充值订单(微信/支付宝)/api/user/withdraw申请提现/api/agent/statistics代理分销统计/api/agent/transfer代理向下级划拨配额限速与隔离
四维限流
触发限流返回 429 并携带 Retry-After 与 X-RateLimit-* 响应头,客户端应指数退避:
HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1787930000隔离机制
· Key 隔离:每个 Key 可独立设置限额(remain_quota)、模型白名单(allow_models)、IP 白名单(CIDR)、有效期。
· 分组隔离:用户按分组隔离可用模型与计费倍率,代理商下游使用代理独立定价。
· 渠道隔离:故障渠道自动熔断(连续失败 5 次冷却 60s),只影响该渠道,不影响同模型其他渠道。
· 数据隔离:代理商仅能访问自己邀请链下游的数据,越权访问返回 40302。
错误码
OpenAI 端点错误:{ error: { message, type, code } };Anthropic 端点:{ type: "error", error: { type, message } };业务接口:{ code, message, data }。
40101authentication_errorKey 无效/过期/被停用40201insufficient_quota余额不足,请充值40303permission_error分组无该模型权限42901rate_limit_error触发限流,按 Retry-After 退避50301unavailable无可用渠道(全部熔断)50401timeout上游超时