开发者文档

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。

模型输入 ¥/1M输出 ¥/1M上下文
deepseek-flash3.2412.961024K
qwen3.8-max-09021854977K
qwen3.8-omni-flash1.625.076977K
glm-5.312421024K
glm-5.3-flash1.24.21024K
glm-5.3-flashx310.51024K
glm-5-turbo7.5331024K
kimi-k2.7-code-highspeed19.581256K
MiniMax-M33.1512.61024K
MiniMax-M2.73.1512.6200K
MiniMax-M2.7-highspeed6.325.2200K
MiniMax-M2.5-highspeed6.325.2200K
MiniMax-M2.1-highspeed6.325.2200K
MiniMax-M23.1512.6200K
ernie-5.1627125K
ernie-5.0936116K
ernie-x1.11.5664K
ernie-4.5-turbo-128k1.24.8135K
agnes-3.0-flash免费0.5132K
ernie-4.5-turbo-vl4.513.5139K
agnes-image-2.0-flash免费¥0.3/次—0
qianfan-ocr0.6752.760K
doubao-seedream-5-0-pro-260628按次¥0.45/次—0
agnes-image-2.5-flash免费¥0.4/次—0
doubao-seed-2-1-pro-2609159451024K
doubao-seedream-5-0-flash-260915按次¥0.18/次—0
doubao-seed-2-1-pro-260628945256K
doubao-seedream-5-0-260128按次¥0.33/次—0
doubao-seed-2-1-turbo-2606284.522.5256K
doubao-seedream-4-0-20260415按次¥0.3/次—0
doubao-seed-2-1-lite-2609151.24.051024K
doubao-seed-character-2606281.23128K
wan3.0-video按次¥9.18/次—0
claude-fable-5-1108540977K
gpt-6-astra1085401025K
claude-fable-5108540128K
gpt-5.554324128K
gpt-image-2-4K按次¥2.16/次—128K
claude-opus-554270128K
gpt-5.6-sol-az43.2216977K
gpt-image-2-adobe按次¥0.54/次—128K
gpt-5.6-sol43.2216977K
gpt-image-2-sp按次¥2.16/次—128K
claude-opus-4-854270128K
claude-opus-4-754270128K
grok-4.721.664.8488K
gemini-3.5-flash16.297.2128K
gemini-3.8-flash8.140.5977K
gemini-3.7-flash8.140.5128K
gemini-3.5-flash-lite3.2427128K
gemini-3.6-flash8.140.5128K
gemini-2.5-flash-image按次¥0.4212/次—128K
gpt-5.6-terra-az21.6129.61025K
gpt-5.6-luna-az2.1612.96128K
gpt-5.6-terra21.6129.61025K
gpt-5.6-luna2.1612.96128K
gpt-5.4-pro3241944977K
gpt-5.4-nano2.1613.5128K
gpt-5.4-mini8.148.6128K
gpt-5.427162977K
gemini-flash-lite-latest1.084.32128K
gemini-3.1-flash-lite2.716.2128K
gemini-3.1-flash-lite-preview2.716.2977K
gemini-3.1-pro-preview-customtools21.6129.6128K
gemini-3.1-pro-preview21.6129.6128K
gemini-3-flash-preview5.432.4128K
gpt-5.3-codex18.9151.2128K
gpt-5.218.9151.2128K
gpt-5.113.5108128K
gemini-2.5-flash-image-preview按次¥0.432/次—128K
gpt-5-mini2.721.6128K
gpt-5-nano0.544.32128K
gpt-513.5108128K
gemini-flash-latest3.2427128K
gemini-2.5-pro13.5108128K
gemini-2.5-flash-lite1.084.32977K
gemini-2.5-flash3.2427128K
o4-mini11.8847.52128K
gpt-4.121.686.4128K
gpt-4.1-mini4.3217.28128K
gpt-4o-mini1.626.48128K
gpt-4o27108128K
o321.686.4128K
grok-4.621.664.8488K
grok-imagine-image-2.0按次¥0.864/次—128K
grok-4.521.664.8128K
claude-sonnet-521.6108128K
claude-opus-4-6-thinking54270128K
claude-sonnet-4-632.4162128K
claude-opus-4-654270128K
claude-haiku-4-5-20251001-thinking10.854128K
claude-opus-4-5-2025110154270128K
claude-haiku-4-5-2025100110.854128K
claude-sonnet-4-5-2025092932.4162128K
text-embedding-3-small0.2160128K
gpt-3.5-turbo-16k32.464.8128K
gpt-3.5-turbo-01255.416.2128K
gpt-oss-120b1.626.48128K
grok-4.313.527128K
grok-4.20-0309-non-reasoning13.527128K
grok-4.20-0309-reasoning13.527128K
flux-2-pro按次¥0.324/次—128K
flux-2-max按次¥0.756/次—128K
imagen-4.0-generate-001按次¥0.648/次—128K
flux-kontext-max按次¥0.864/次—128K
grok-imagine-image按次¥0.216/次—128K
flux-kontext-pro按次¥0.432/次—128K
flux-pro-1.1按次¥0.432/次—128K
text-embedding-3-large1.4040128K
gpt-6-luna1.085.4128K
gpt-6-sol21.6108128K
claude-opus-5-543.2216128K
o1162648128K
agnes-video-2.5按次¥2.125/次—0
deepseek-v4-pro14.25642.7681024K
gpt-image-2.5-sunburst按次¥0.668/次—128K
gpt-image-2.5-flare按次¥0.0648/次—128K
gpt-5.2-codex18.9151.2128K
gpt-6.1-sol21.61081025K
text-embedding-ada-0021.080128K
claude-sonnet-5-521.6108977K
claude-haiku-5-51.085.4977K
gpt-5.3-chat18.9151.2128K
qwen3.8-flash1.24.05977K
kimi-k3301501024K
qwen3.8-27b5.432.4977K
qwen3.8-2.4t-a95b21.664.8977K
qwen3.8-max1854977K
qwen3.7-flash0.31.2977K
qwen3.7-text-embedding0.750128K
glm-5.212421024K
kimi-k2.7-code9.7540.5256K
qwen3.5-ocr0.75364K
qwen3.7-plus312977K
qwen3.7-max927977K
kimi-k2.69.7540.5256K
qwen3.6-flash1.810.8977K
glm-5.19361024K
qwen3.6-plus318977K
qwen3-asr-flash-2026-02-1013.204K
glm-56271024K
MiniMax-M2.53.1512.6200K
glm-4.7312200K
MiniMax-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

接口一览

GET/v1/models当前 Key 可用模型列表
POST/v1/chat/completions对话补全(OpenAI 兼容,SSE 流式)
POST/v1/messages对话(Anthropic 兼容,事件流式)
POST/v1/embeddings文本向量化(按 token 计费)
POST/v1/images/generations图像生成(按次计费)
POST/v1/audio/speech语音合成(按次计费)
POST/v1/audio/transcriptions语音转写(multipart,按 token)
POST/v1/videos/generations视频生成(异步任务,按次计费)
GET/v1/dashboard/billing/usage消耗查询(兼容第三方客户端)
POST/api/public/auth/register注册(送 1,000,000 配额)
POST/api/public/auth/login登录(JWT access + refresh)
GET/api/user/wallet钱包余额查询
POST/api/user/tokens签发 API Key
GET/api/user/logs调用日志(游标分页)
POST/api/user/orders创建充值订单(微信/支付宝)
POST/api/user/withdraw申请提现
GET/api/agent/statistics代理分销统计
POST/api/agent/transfer代理向下级划拨配额

限速与隔离

四维限流

维度默认值说明
Key 级 RPM/TPM60 / 90,000单 Key 每分钟请求数 / token 数
用户日配额按分组用户级每日消耗上限
IP 级5 次/天注册防薅羊毛与爆破
模型并发全局防单模型打爆上游渠道

触发限流返回 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上游超时