B

BitVoxMASS Platform

一个 base_url，接入全部模型

面向开发者的多模型 API 平台。OpenAI、Claude、Gemini、通义、DeepSeek、Kimi、豆包、Seedance 等 20+ 家供应商收敛在同一套协议上：换模型只改 model 一个字段，SDK 和业务代码不动。 平台负责路由、故障切换、限流、计费与对账。

接入信息

三步接入

• 向平台申请 API Key（当前为邀请制开通，由管理员发放到账户）。
• 把现有 OpenAI 客户端的 base_url 指向 https://www.bitvox.cn/v1。
• 用 GET /v1/models 拉取已开通模型，按 model 字段切换。

调用示例

# pip install openai
from openai import OpenAI

client = OpenAI(
    base_url="https://www.bitvox.cn/v1",
    api_key="mass-sk-...",
)

resp = client.chat.completions.create(
    model="deepseek-chat",          # 换模型只改这一行
    messages=[{"role": "user", "content": "用一句话解释向量数据库"}],
)
print(resp.choices[0].message.content)

// npm i openai
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://www.bitvox.cn/v1",
  apiKey: process.env.MASS_API_KEY,
});

const stream = await client.chat.completions.create({
  model: "qwen-plus",
  messages: [{ role: "user", content: "写一段商品文案" }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

# 非流式
curl https://www.bitvox.cn/v1/chat/completions \
  -H "Authorization: Bearer $MASS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"你好"}]}'

# 流式：加 "stream": true，返回 SSE（data: {...} 逐帧，末帧 data: [DONE]）

# 查余额
curl https://www.bitvox.cn/v1/balance -H "Authorization: Bearer $MASS_API_KEY"

模型目录

下表为平台已接入的模型目录与售价（人民币）。实际可调用集合以 GET /v1/models 实时返回为准： 未开通上游渠道的模型、以及渠道整体熔断（不可用）的模型，都不会出现在该接口里。当前为邀请制内测，按账户开通所需模型。

模型 ID	说明	输入 / 百万 token	输出 / 百万 token
gpt-4o-mini	OpenAI 轻量通用	¥1.10	¥4.40
gpt-4o	OpenAI 旗舰多模态	¥18.00	¥72.00
claude-haiku	Anthropic 快速档	¥7.20	¥36.00
claude-sonnet	Anthropic 主力档	¥21.60	¥108.00
gemini-flash	Google 高性价比	¥2.20	¥18.00
gemini-pro	Google 长上下文	¥9.00	¥72.00
grok	xAI	¥21.60	¥108.00
deepseek-chat	DeepSeek V3	¥2.00	¥8.00
deepseek-reasoner	DeepSeek 推理（含思维链）	¥4.00	¥16.00
qwen-plus	通义千问 均衡档	¥0.80	¥2.00
qwen-max	通义千问 旗舰档	¥2.40	¥9.60
kimi	月之暗面 K2	¥4.00	¥16.00
glm-4.6	智谱旗舰	¥4.00	¥16.00
glm-4-flash	智谱免费档	¥0.01	¥0.01
doubao	火山方舟豆包	¥0.80	¥2.00
hunyuan	腾讯混元	¥0.80	¥2.00
ernie	百度文心	¥0.80	¥3.20
minimax	MiniMax	¥1.00	¥1.00
step	阶跃星辰	¥3.00	¥8.00
yi-large	零一万物	¥20.00	¥20.00
llama-3.3-70b	开源 Llama（Groq / Together）	¥4.00	¥4.00
llama-4-scout	开源 Llama 4	¥0.80	¥2.40
qwen-2.5-72b	开源通义（Together / 硅基流动）	¥4.00	¥4.00

视频模型（异步任务，按秒计费）

视频不是同步接口：先建任务拿 ID，再轮询取结果。调用方式见下方端点表，价格单位为「元 / 秒」。

模型 ID	说明	480p	720p	1080p
doubao-seedance-2-5-my-test	Seedance 2.5，4–30 秒	¥0.51	¥0.85	¥1.87
doubao-seedance-2-0-my-test	Seedance 2.0，4–15 秒	¥0.33	¥0.55	¥1.21
dreamina-seedance-2.5-test	即梦 Seedance 2.5	¥0.51	¥0.85	¥1.87
dreamina-seedance-2.0-test	即梦 Seedance 2.0	¥0.33	¥0.55	¥1.21

# 提交任务
curl https://www.bitvox.cn/v1/video/generations \
  -H "Authorization: Bearer $MASS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"doubao-seedance-2-5-my-test","prompt":"雨夜霓虹街头，橘猫缓步走过","duration":5,"resolution":"720p"}'

# 轮询：queued → processing → completed（url 为成品地址）/ failed（自动退款）
curl https://www.bitvox.cn/v1/video/generations/vid_xxx \
  -H "Authorization: Bearer $MASS_API_KEY"

端点

方法	路径	说明
POST	/v1/chat/completions	对话补全，支持 stream:true、工具调用、多模态 content 数组
POST	/v1/video/generations	提交视频任务，返回 id；按「时长 × 分辨率单价」冻结
GET	/v1/video/generations/{id}	查询任务状态与结果（读平台侧记录，不回源上游）
GET	/v1/models	当前可调用模型列表（渠道全挂的模型不返回）
GET	/v1/balance	余额：available / frozen / spent / debt
GET	/healthz	存活探针，不鉴权

幂等：写接口支持 Idempotency-Key 请求头（≤255 字符）。同键重放不会重复扣费，返回首次结果； 并发同键返回 409 request_in_progress。

计费与账务

环节	行为
请求前	按候选渠道的最高单价估算用量并冻结，余额不足直接 402
响应后	按上游返回的真实 usage 结算，多冻部分立即退回
上游失败	自动换渠道重试；全部失败则全额退款，返回 502
客户端断连	已产生的用量照常结算，不因断连而免单
视频任务	提交即冻结；完成按上游实际时长结算；失败/超时全额退款

余额单位是 credit（1 credit = ¥1），/v1/balance 返回 6 位小数。账单可按请求 ID 逐笔追溯。

错误码

HTTP	code	含义与处置
400	invalid_request_error	请求体非法、模型类型用错端点（如拿视频模型打 chat）
401	invalid_api_key	Key 缺失或失效
402	insufficient_quota	余额不足，需充值
404	model_not_found	模型未上架或该账户未开通
404	task_not_found	视频任务不存在或已过保留期
409	request_in_progress	同 Idempotency-Key 的首个请求仍在处理
429	quota_exceeded	触及日限额或渠道限流，可按指数退避重试
502	upstream_error	全部候选渠道失败，预扣已退回
503	upstream_unavailable	该模型当前无可用渠道（熔断中），稍后重试
500	internal_error	平台内部错误，可重试；持续出现请联系管理员