DEEPBLUE AGGREGATION SDK

一个账号，连接模型与整个 AI 实战生态

自己写脚本时用个人 Key，开发面向其他用户的产品时用应用双凭证。两种方式都不需要保存 AI历史书密码，也不需要把模型供应商密钥交给终端用户。

生成个人 Key 申请开发者应用

个人调用: 个人 Key
应用接入: OIDC + 应用密钥
计量: 统一 Token 账本
正文存储: 默认不入账本

接入路线

先判断你为谁调用

A
只给自己使用
在账号中心生成个人 Key，从自己的服务端调用，直接消费本账号 Tokens。
B
给产品用户使用
申请并审核开发者应用，使用应用密钥识别产品、OIDC Access Token 识别用户。
1
密钥永不进入客户端
个人 Key 与应用密钥都只在签发时显示一次，平台只保存 SHA-256 摘要。
2
从服务端调用
每次调用都写入统一用量账本，可在账号中心核对余额与消耗。

AUTH MODEL

双凭证，不把责任混在一起

浏览器 / 小程序用户 Access Token

回答“谁在使用、扣谁的额度”。短期保存，不写进日志。

你的服务端X-Deepblue-App-Key

回答“哪个应用调用、归因给谁”。永远不下发客户端。

→

聚合网关鉴权、限流、路由、计量

正文只发给模型供应商；平台账本记录哈希、用量和状态。

PERSONAL KEY

用自己的 Tokens，最短一条请求即可调用

在“账号中心 → 模型额度与赞助”生成以 dpk_live_ 开头的个人 Key。它只代表你本人，不具备应用分成和代其他用户扣费能力；最多同时保留 5 个，有效期 365 天，可随时撤销。

个人 Key · 查询余额

curl "https://ailishishu.com/ailishishu-stats/api/developer-gateway.php?action=balance" \
  -H "Authorization: Bearer dpk_live_***"

个人 Key · Chat

curl https://ailishishu.com/ailishishu-stats/api/developer-gateway.php \
  -H "Authorization: Bearer dpk_live_***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role":"user","content":"解释混合专家模型"}],
    "max_tokens": 1800
  }'

只在你自己的服务端环境变量或密钥管理器中保存，禁止写入网页、小程序、客户端安装包或公开仓库。
完整 Key 只显示一次；遗失后不能找回，请撤销旧 Key 并生成新的。
如果怀疑泄露，立即在账号中心撤销；撤销会立刻阻止后续请求。

API v1

模型、对话、额度与用量使用同一双凭证

Chat · cURL

curl https://ailishishu.com/ailishishu-stats/api/developer-gateway.php \
  -H "Authorization: Bearer USER_ACCESS_TOKEN" \
  -H "X-Deepblue-App-Key: dsk_live_***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role":"user","content":"解释这个概念"}],
    "thinking": {"type":"disabled"},
    "max_tokens": 1800
	  }'

读取接口

GET ?action=models · 当前可用模型
GET ?action=balance · AI 币余额、Tokens 额度与用量账本
GET ?action=usage · 当前应用最近 100 次调用
所有接口都需要用户 Bearer 与应用密钥

Chat 返回计量

prompt_tokens / completion_tokens
completion_tokens_details.reasoning_tokens
total_tokens · 本次真实用量
token_allowance_after · 自动补满后的 Tokens 额度
refill_coins / refill_tokens · 本次自动补满与整数扣币
deepblue_coin_charged / deepblue_coin_balance / deepblue_coin_overdraft · 扣币、负余额与欠额

Node.js SDK

import { DeepblueAI } from '@deepblue-ai/sdk';
const ai = new DeepblueAI({ appKey: process.env.DEEPBLUE_APP_KEY });
const models = await ai.listModels({ accessToken: userAccessToken });
const reply = await ai.chat({
  accessToken: userAccessToken,
  model: models.data[0].id,
  messages: [{ role: 'user', content: '解释这个概念' }]
});

ERROR CONTRACT

所有端使用同一套可诊断错误

HTTP	错误码	客户端动作
401	invalid_personal_key / invalid_app_key / session_expired	检查或撤销重建密钥；应用用户重新授权
402	coin_minimum_balance	AI 币达到 10 枚后重试；引导签到、邀请或赞助
402	coin_insufficient_balance / token_allowance_insufficient	停止自动重试，打开账号中心查看 AI 币与 Tokens 额度
403	scope_denied	停止调用并检查密钥权限
429	rate_limited	指数退避，不要立即循环重试
502	provider_failed	展示可重试状态并保留用户输入

MULTI-END

Web、H5、小程序共用业务合同

WEBOIDC + PKCE

回调页交换 Token；应用密钥留在 BFF 服务端。

H5同域会话桥

在微信内仍走服务端授权，不把密钥注入 WebView。

小程序code → 服务端会话

小程序登录码先换业务会话，再关联统一账号 subject。

UI 可以各端适配，订单、Token、权益、版本和分成必须写入同一个服务端事实模型；客户端缓存不是余额事实。

ATTRIBUTION

渠道关系固定，订单分成按版本冻结

应用渠道链接首次有效绑定用户统一账号赞助 / 购买订单行快照结算推广者 / 创作者 / 平台

普通邀请成功后，邀请人获得 100 枚深蓝 AI 币与 7 天会员；每邀请一人再累加一份。
被邀请人以后每次有效赞助，邀请人继续按实付金额获得 AI 币回馈；当前默认每 1 元回馈 10 币。
模型账号默认有 20 万 Tokens；额度降至 15 万或以下时，按 1 币 / 1 万 Tokens 的整数规则补满到 20 万，单次最低扣 5 币。已开始的调用允许把余额结算为负数，下一次调用前余额必须恢复到至少 10 币。
只保留一层邀请关系，不能自邀、循环或在首笔订单后改绑。
后台调整比例只生成新版本，历史订单继续使用下单时快照；退款用反向分录处理。
深蓝 AI 币是站内权益，不可转账、提现或承诺兑换法币。