NB文档doc.nbjs.ai
AI 网关 / 网关与鉴权

网关与鉴权

ai 是平台 AI 网关:文本、图片、语音、识别、视频,以及计费、私钥和支付。

接口

方法路径作用
POST/v1/chat/completionsOpenAI 兼容文本补全
POST/v1/images/generations文生图,返回图片 URL
POST/v1/audio/speechTTS,音频或音频 + SRT
POST/v1/audio/transcriptionsASR,文本或文本 + SRT
POST/v1/videos/generations视频生成,默认等待完成
GET/v1/tasks/:id查询视频任务
GET/v1/models可用模型
GET/v1/rates当前计费表
GET/v1/balance当前账号余额
POST/mcpAI 能力 MCP

旧入口 /api/ai、/api/chat/completions 保留,agent 的页面仍在用。

三种凭证

  1. 浏览器 nb_token Cookie。
  2. Authorization: Bearer <JWT>,平台共享 jwt_secret 签发。
  3. Authorization: Bearer sk-nb-...,AI 私钥,库里只存 SHA-256,可撤销。

也可以用 x-api-key 代替 Authorization。

私钥管理

curl -X POST https://ai.nbjs.ai/v1/keys \
  -H "authorization: Bearer $NB_TOKEN" \
  -H "content-type: application/json" \
  -d '{"name":"my-app"}'

返回的明文 key 只出现一次。列表和撤销:

GET    /v1/keys
DELETE /v1/keys/:id

模型

默认文本模型是 deepseek-flash,图片 wanx2.1-t2i-turbo,TTS cosyvoice-v2,识别 fun-asr-flash-2026-06-15,视频 wanx2.1-t2v-turbo。模型名和单价都在 ai/nb.toml 里配置。