1. 平台介绍
盈讯智能平台是一个 OpenAI 协议兼容 的国产大模型 API 网关。你用一枚本站令牌,即可调用 DeepSeek、通义千问、智谱 GLM、Kimi、豆包、MiniMax、文心、混元、阶跃、星火、零一万物、百川、商汤、 书生等厂商的 60 个模型,无需分别注册与维护账单。平台不接入境外模型。
统一入口:
https://your-domain.com/v1
支持的能力:
POST /v1/chat/completions—— 对话补全,支持stream流式输出GET /v1/models—— 列出当前可用模型
请求、响应、错误结构均与 OpenAI 官方一致,现有 SDK 只需修改
base_url 与 api_key。
常用模型 id 速查
| 场景 | 推荐模型 id | 说明 |
|---|---|---|
| 通用主力 | deepseek-flash | 输入 2 元 / 输出 8 元,空闲时段半价 |
| 复杂推理 | step-5-preview / kimi-k3.1-pro | 长程推理、专业知识工作与复杂 Agent 任务 |
| 中文旗舰 | qwen3.8-max / glm-5.3 | 输入 12 元 / 8 元,旗舰档 |
| 低成本量产 | qwen3.8-flash / glm-5.3-flash | 输入 0.8 元,百万级日调用首选 |
| 超长文档 | kimi-k3.1-pro / MiniMax-M3 | 1M 上下文,整本资料一次读完 |
| Agent 编码 | doubao-seed-evolving / doubao-seed-2.0-code | 工具调用、持续升级与仓库级重构 |
| 视觉理解 | doubao-seed-2.1-pro / hy4 | 图片问答、图表解读与 OCR |
完整清单与价格见 官网模型广场 或控制台「模型广场」。
2. 注册与登录
2.1 注册
- 打开 注册页,填写邮箱与至少 8 位密码;
- 提交后自动登录,账户余额立即到账 ¥5 体验金;
- 无需邮箱验证与绑卡,可直接开始调用。
2.2 登录状态
登录成功后服务端下发 HttpOnly 会话 Cookie,有效期 7 天,签名防篡改。
会话仅用于控制台,不能用于调用 API —— 调用必须使用 API 令牌。
2.3 账号安全
- 密码使用 PBKDF2-SHA256(24 万轮)加盐散列存储,平台无法还原明文;
- 连续输错不会锁定,但建议使用独立密码;
- 发现令牌泄漏,立即在控制台删除该令牌,请求会立刻失效。
3. 创建 API 令牌
令牌(API Key)是调用中继的唯一凭证,格式为 sk-yx- 加 40 位随机串。
- 登录后进入 控制台 → API 令牌;
- 点击「新建令牌」,填写名称、额度上限(可留空表示不限)、绑定子账号(可选)、有效期(可选);
- 创建成功后弹窗展示完整密钥,仅此一次,请立即复制保存。
平台数据库中只保存密钥的 SHA-256 哈希,因此无法再次查看明文。遗失只能重建。
令牌可以做什么
- 独立限额:设置额度上限后,该密钥累计消费触顶即拒绝,不影响其他令牌;
- 随时停用:一键停用,无需删除即可临时切断调用;
- 绑定子账号:把用量归集到团队或项目,便于分账。
4. 发起调用
4.1 cURL
curl https://your-domain.com/v1/chat/completions \
-H "Authorization: Bearer $YX_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-flash",
"messages": [{"role": "user", "content": "你好"}]
}'
4.2 Python(openai SDK)
from openai import OpenAI
client = OpenAI(
base_url="https://your-domain.com/v1",
api_key="sk-yx-...",
)
resp = client.chat.completions.create(
model="qwen3.8-flash",
messages=[{"role": "user", "content": "用一句话解释什么是 API 中转站"}],
)
print(resp.choices[0].message.content)
4.3 流式输出
stream = client.chat.completions.create(
model="glm-5.3",
messages=[{"role": "user", "content": "写一段 100 字的文案"}],
stream=True,
)
for chunk in stream:
delta = chunk.choices[0].delta.content if chunk.choices else None
if delta:
print(delta, end="", flush=True)
流式响应为标准 SSE:每条 data: {...} 分片携带增量内容,结尾是 usage 分片与
data: [DONE]。费用按实际输出 tokens 结算,与流式/非流式无关。
4.4 Node.js
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://your-domain.com/v1",
apiKey: process.env.YX_KEY,
});
const r = await client.chat.completions.create({
model: "kimi-k3.1-pro",
messages: [{ role: "user", content: "hello" }],
});
console.log(r.choices[0].message.content);
4.5 响应示例
{
"id": "chatcmpl-9f2c...",
"object": "chat.completion",
"created": 1794632792,
"model": "deepseek-flash",
"choices": [{
"index": 0,
"message": { "role": "assistant", "content": "..." },
"finish_reason": "stop"
}],
"usage": { "prompt_tokens": 10, "completion_tokens": 217, "total_tokens": 227 }
}
5. 子账号与额度
子账号用于把一个账户下的用量拆给不同团队或项目,本身不产生新的密钥,需由令牌绑定后生效。
- 每个子账号可设独立额度;留空表示不限,跟随账户余额;
- 令牌绑定子账号后,其消费同时计入子账号用量与个人账户余额;
- 子账号额度用尽时,其下所有令牌一起返回
402; - 删除子账号会自动解绑其令牌,令牌回落为使用账户额度。
一次调用同时受三层约束:账户余额 → 子账号额度 → 令牌额度,任意一层不足即拒绝,且不产生费用。
6. 充值与计费
6.1 计费方式
按 tokens 后付费。单价以「元 / 百万 tokens」展示,输入与输出分别计价:
费用 = 输入 tokens × 输入单价 / 1,000,000
+ 输出 tokens × 输出单价 / 1,000,000
余额以「微元」(0.000001 元)整数存储与扣减,因此小额调用不会因浮点误差被抹零。 每次调用的 tokens、费用、延迟、状态码都会写入日志,可在控制台按时间与模型筛选。
6.2 充值
- 进入 控制台 → 充值,选择档位;
- 当前演示环境为模拟支付通道,点击即入账,不产生真实扣款;
- 也可使用兑换码:输入后立即到账,一次性核销。
上线前必须把模拟支付替换为支付宝/微信正式通道,并在服务端校验签名与订单金额,禁止前端直接调用加款接口。
7. 错误码
错误响应遵循 OpenAI 结构:
{ "error": { "message": "账户余额不足,请先充值",
"type": "insufficient_quota",
"param": null,
"code": "insufficient_quota" } }
| HTTP | code / type | 含义与处理 |
|---|---|---|
| 400 | invalid_request_error | 参数缺失、模型不支持或 messages 为空,检查请求体 |
| 401 | invalid_api_key | Key 不存在、已删除或已停用 |
| 401 | expired_api_key | Key 超过有效期,重建或延长有效期 |
| 402 | insufficient_quota | 余额、子账号额度或令牌额度不足,充值或提额 |
| 403 | account_disabled | 账号被封禁,联系管理员 |
| 403 | subaccount_disabled | 绑定的子账号已停用 |
| 502 | upstream_error | 全部上游渠道失败,稍后重试或联系管理员 |
| 503 | model_unavailable | 该模型暂无可用渠道 |
幂等与重试建议
- 对
429/502/503做指数退避重试(建议 3 次,间隔 1s/3s/8s); - 不要对
400/401/402/403重试,先修正请求或额度; - 流式请求中断后重发会产生二次计费,建议在业务侧做去重。
最后更新:2026-11 · 与当前部署版本 v1.0.0 对应