PUBLIC / DOCS
接入文档
接入指南、协议规范与贡献者指南。协议以 spec 为唯一真相源（当前契约 1.2.5）。
接入指南
示例 base_url 为 https://api.example.invalid/v1（仅作格式示意，请替换成你自己的实际端点），用 API Key 走 OpenAI 兼容接口；流式与非流式同一入口。
Key 只在创建时显示一次，之后只能看到前缀。
协议规范
OpenAPI 3.1；同一 MAJOR 内只加不改，客户端必须容忍未知字段与未知枚举值。
错误统一 error 信封：type / code / message / request_id。
贡献者指南
代码开源、日志可导出、账本可验证。提交前请阅读贡献规则与边界检查清单。
贡献端按完成任务直接结算 USDT。
三步跑通第一次调用
- 在控制台创建 API Key，明文只在创建时保存。
- 把 base_url 指向服务方端点，model 填模型广场里的 slug。
- 看响应与错误信封里的 request_id，排障时带上它。
curl -sS https://api.example.invalid/v1/chat/completions \
-H "Authorization: Bearer $DJB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"djb-standard","messages":[{"role":"user","content":"ping"}]}'示例域名仅作格式示意，请替换为你自己的实际端点。
绑定网页端（客户端接入）
客户端要绑到你的账户才会接单：绑定码由网页端在登录态下签发，客户端粘贴。登录不等于绑定。
- 网页端 → 节点页 →「生成绑定码」（一次有效、10 分钟内用掉，明文只显示一次）。
- 客户端 →「账户 → 绑定网页端」粘贴绑定码，或命令行 djb auth --bind <码>。
- 回网页端节点页填 节点 ID、客户端密钥与绑定码 → 提交。
- 看回执：已下发 / 待节点回执（离线，联网后生效）；离线不等于未绑定。
- 绑定成功后到账户页设置额度与护栏，再开始共享。
命令行等价写法：djb auth --bind <一次性码>
绑定码一次性、10 分钟过期，过期回节点页重新生成；网页端不要填上游 API Key。
常见问题
为什么账单金额和页面预估不一样？
账单以账本分录聚合为准，成交价由竞价决定。
为什么共享端显示「待节点回执」？
网页改的设置已下发，节点离线，联网后才会生效。
Token 和积分能换成现金吗？
都不能。Token 只抵扣推理；积分只在自己算力不足时抵扣，不承诺收益。