API 文档
使用一个平台 Key 调用 OpenAI 兼容接口。生产 Base URL：https://nbapi.ai/v1。
准备工作
- 在买家门户创建项目。
- 选择已审核模型并提交额度订单，等待运营确认到账。
- 为项目生成平台 Key；完整 Key 只显示一次。
接口
| 方法 | 路径 | 用途 |
|---|---|---|
| GET | /v1/models | 列出当前项目已购买的模型 |
| POST | /v1/chat/completions | 文本对话；支持非流式与 SSE 流式 |
Python 快速开始
from openai import OpenAI
client = OpenAI(base_url="https://nbapi.ai/v1", api_key="你的平台 Key")
response = client.chat.completions.create(
model="已购买模型",
messages=[{"role": "user", "content": "Hello"}],
)流式调用
设置 stream=True；平台要求最终 SSE 事件包含有效 usage 后才完成结算。已产生输出的连接不要自动重试。
兼容范围
当前仅支持 GET /v1/models 和 POST /v1/chat/completions，文本 messages、非流式与 SSE 流式调用，以及文档中列出的采样字段。暂不支持 embeddings、images、audio、responses、tools、assistants、batches 或其他 OpenAI API 路径；不要把“OpenAI 兼容”理解为全量兼容。
费用与幂等
模型目录展示输入/输出单价；实际费用按上游返回的 usage 计算，并按门户展示的平台费率计入。订单和提现接口必须设置唯一 Idempotency-Key，门户会自动生成并在失败重试时复用；相同 Key 不会创建第二笔记录。模型调用建议每次逻辑请求设置唯一 Key；重复 Key 返回 HTTP 409，当前没有按 Key 查询原请求结果的接口，请保存首次响应中的 X-Request-ID 并联系支持。
| 状态 | 含义 | 处理 |
|---|---|---|
| 401 | 平台 Key 无效或已撤销 | 在买家门户重新生成 Key |
| 409 | 幂等 Key 已处理 | 不要换 Key 重放；保留首次响应和请求 ID |
| 429 | 并发或每分钟限额 | 平台限流按 Retry-After（秒）退避；上游 429 需指数退避 |
| 502 | 上游调用失败 | 未产生输出时可使用新的幂等 Key 重试 |
安全
只通过 HTTPS 使用平台 Key，不要把 Key 放入浏览器前端、公开仓库或支持工单。发现泄露后立即在买家门户撤销。