一个统一 BaseURL
调度全部模型资源
遵循 OpenAI 兼容协议,聚合上百款公有模型、本地私有化部署开源模型;Agent 智能编排调用链路,
减少冗余推理,节省算力消耗;仅切换 model 参数即可调用不同模型,业务代码无需改动。
智能路由、故障切换、并发限流、租户鉴权、计费对账、全链路审计;支持同步对话、异步图像、视频生成等多模态任务。
Agent 智能编排
混合算力调度
租户隔离
故障容灾
算力优化降本
按量计费
多模态任务
OpenAI 兼容
01
模型目录
点任意模型复制 ID。价格与 GET /v1/models 的 pricing 同源。
02
三步接入
任何 OpenAI 兼容 SDK 直接换地址即可,业务代码不用动。
1
注册,立刻拿 Key
手机号 + 密码开通,注册成功当场签发 mass-sk- Key,不用等审核。
2
改 base_url
把 OpenAI 客户端地址换成平台地址,Key 换成自己的。
3
换 model 字段
用 GET /v1/models 拉已开通模型,换供应商只改一行。
Base URL
https://www.bitvox.cn/v1
鉴权
Authorization: Bearer <API Key>
协议
OpenAI 兼容 · JSON / SSE
03
复制就能跑
对话(流式)、余额、视频任务各一段,能直接运行。
# 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 c of stream) process.stdout.write(c.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 # 查余额 / 模型价格 curl https://www.bitvox.cn/v1/balance \ -H "Authorization: Bearer $MASS_API_KEY"
# 1. 提交视频任务,按「时长 × 分辨率」冻结 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"}' # 2. 轮询:queued → processing → completed curl https://www.bitvox.cn/v1/video/generations/vid_xxx \ -H "Authorization: Bearer $MASS_API_KEY" # 3. 成品下载(无公开直链时由平台代理) curl -L .../video/generations/vid_xxx/content -o out.mp4
04
端点 · 计费 · 错误码
收进三个折叠面板,要用的展开。
端点清单
POST/v1/chat/completions
GET/v1/models 带 type 与 pricing
GET/v1/balance
POST/v1/video/generations
GET/v1/video/generations/{id}
GET/v1/video/generations/{id}/content
POST/v1/auth/register · login · logout
GET/v1/auth/me
GET/healthz · /readyz
写接口支持 Idempotency-Key;业务端点已开放 CORS;每个响应都带 X-Mass-Request-Id。
计费规则
请求前按候选渠道最高单价估算并冻结,余额不足直接 402
响应后按上游真实 usage 结算,多冻部分立即退回
失败自动换渠道重试;全部失败全额退款
视频提交冻结,完成按实际时长结算,失败 / 超时全退
余额单位 credit(1 credit = ¥1),返回 6 位小数;单价可从 /v1/models 读取。
错误码
401invalid_api_key · Key 缺失或失效
402insufficient_quota · 余额不足
404model_not_found / task_not_found
409request_in_progress · 幂等键冲突
429rate_limit_exceeded / quota_exceeded
5xxupstream_error · upstream_unavailable
只有 429 / 5xx 值得重试,且必须带同一个 Idempotency-Key。