宁享Token API 文档

主题

主页控制台

API 变更日志 ​

记录 宁享Token API 的版本变更。日期为北京时间（UTC+8）。

v167 (2026-08-25) ​

改进 ​

  • 速率限制口径统一为 RPM（每分钟请求数）：全站限流控制与监控展示统一采用 业界标准的 RPM + TPM + 并发三闸门维度（对标 OpenAI / Anthropic 等）。此前文本类 模型按秒窗口（RPS）计量，现统一为分钟窗口——对持续流量语义等价，对短时突发更 宽容（突发防护由并发限制兜底）。后台规则按分钟配置，监控面板（我的 Key 流量、 流量分布等）均展示 RPM 口径。
  • 模型级别限流：支持「全部模型合计」+「指定模型专属」两层叠加配置， 两类同时生效取更严者——对特定模型单独设限不影响其他模型的吞吐。
  • DeepSeek 系列峰谷计费：deepseek-v4-flash / deepseek-v4-flash-0731 / deepseek-v4-pro 在工作日 09:00-12:00 / 14:00-18:00 为高峰价（标准价）， 其余时段及周末全天为低谷价（5 折）。具体按请求实际命中的时段计价。
  • 限流等待上限改秒输入：后台限流规则「等待上限」改为按秒填写（上限 1 小时）， 超过 120 秒给出友好提示（不强制拦截）。

⛔ 本条为 v167 当时的实现口径，其中峰谷部分已于 2026-10-02 变更： 计费存储改为 micro 人民币（USD 不进存储、不进结算）；峰谷的法定节假日不再自动按谷计费， 须由运营显式配置节假日日期才生效，未配置时按该日所在星期计价。 现行口径见 NX-api/docs/修复报告-峰谷节假日口径收口-20261002.md 与 NX-api/docs/普查-USD与quota下线-20261001.md； 决策成因见 NX-api/docs/架构决策-20261002-口径与契约基线.md， 本批全量逐条对齐账见 NX-api/docs/文档代码对齐-20261002.md。

修复 ​

  • 历史峰谷计费纠偏：修复一段时期谷时请求被误按高峰价计费的问题，受影响记录 已按低谷价回补（消费额度减半、余额退回），并全量标记可追溯。

v166 (2026-08-18) ​

新增 ​

  • Seedance 2.5 视频模型：doubao-seedance-2-5 / doubao-seedance-2-5-260628
    • 不含视频输入 ¥70 / 含视频输入 ¥42（元/百万 tokens）
    • 480p / 720p / 1080p 三档同价（官方确认 1080p 与 720p 价格一致）
    • 支持最长 30 秒、24fps 视频生成

修复 ​

  • 模型定价货币单位：多档价格编辑器（Seedance 分档）显示/输入统一为人民币（¥）， 内部存储 USD（÷汇率），标签与数值一致，不再出现 6.5714 类美元数字
  • JSON 配置 textarea：保持 USD 原始值（高级编辑），避免与可视化编辑器双重换算

⛔ 本条为 v166 当时的实现口径，其中金额存储部分已于 2026-10-02 变更： 现行系统的唯一金额基础单位是 micro 人民币（1 元 = 1,000,000 微）， USD 不进存储、不进结算；USD 仅作为对外协议兼容的展示参考字段保留。 现行口径见 NX-api/common/money.go 与 NX-api/setting/operation_setting/rate.go； 决策成因见 NX-api/docs/架构决策-20261002-口径与契约基线.md， 本批全量逐条对齐账见 NX-api/docs/文档代码对齐-20261002.md。

⛔ 同条上方「480p / 720p / 1080p 三档同价（官方确认 1080p 与 720p 价格一致）」亦已不成立（2026-10-02 订正）： 官方价格页逐字为 480p/720p 70 / 42、1080p 77 / 46（元/百万 tokens，输入不含 / 含视频）， 出处 NX-api/docs/基线-原厂契约/基线-字节豆包Seed-20261001.md:307-310。 ⇒ 本页 2026-08-18 当时「三档同价、无 4K 档」的理解不成立（现行为正确值见 docs-site/models/video-models.md 与 docs-site/models/pricing-table.md）。

v142 (2026-08-04) ​

新增 ​

  • 客户对账 API：新增 13 个端点，支持客户维度的账单查询与对账

    • GET /api/billing/overview — 账单总览
    • GET /api/billing/summary — 月度汇总
    • GET /api/billing/details — 明细列表
    • GET /api/billing/records — 记录列表
    • GET /api/billing/records/{id} — 单条记录详情
    • GET /api/billing/by-model — 按模型汇总
    • GET /api/billing/by-vendor — 按厂商汇总
    • GET /api/billing/by-day — 按日汇总
    • GET /api/billing/by-client-key — 按 API Key 汇总
    • GET /api/billing/export — 导出 CSV
    • POST /api/billing/reconcile — 发起对账
    • GET /api/billing/reconcile/{id} — 对账状态查询
    • GET /api/billing/invoices — 发票列表

  • 素材库 API：新增活体认证端点

    • POST /api/assets/liveness/session — 创建活体认证会话
    • GET /api/assets/liveness/history — 活体认证历史

改进 ​

  • glm-5.2 最大输出从 16,000 提升至 131,072
  • deepseek-v4-pro 最大输出从 64,000 提升至 384,000
  • Chat Completions 响应新增 system_fingerprint 字段
  • 流式响应首包延迟降低 ~30%

修复 ​

  • 修复 kimi-k3 流式响应偶发断流问题
  • 修复 doubao-tts-2.0 中文标点停顿异常
  • 修复上下文缓存命中率统计不准的问题

v141 (2026-07-20) ​

新增 ​

  • 视频生成 API：新增 sora 模型，支持最长 20 秒 1080p 视频生成
  • 音频 API：新增 suno-v4 音乐生成模型
  • glm-5.2 新增思考模式（reasoning_effort 参数）

改进 ​

  • 图像生成支持 response_format: "b64_json"，可直接返回 Base64
  • TTS 支持流式输出（stream: true）
  • 错误响应新增 request_id 字段

修复 ​

  • 修复 flux-pro 高分辨率偶发 500 错误
  • 修复 whisper-large-v3 长音频识别截断问题

v140 (2026-07-05) ​

新增 ​

  • 视频生成 API：正式发布，支持 seedance / kling-v3 / kling-3.0-turbo / hailuo / vidu
  • 素材库 API：新增素材管理端点，支持图片、视频、音频上传与管理
  • kimi-k3 模型上线，支持 1M 上下文

改进 ​

  • Chat Completions 支持 cache: true 上下文缓存
  • Embeddings 响应新增 usage.prompt_tokens 字段
  • 统一 OpenAI 兼容端点路径

修复 ​

  • 修复 deepseek-v4-pro 工具调用参数解析异常
  • 修复并发场景下 429 误触发问题

v139 (2026-06-15) ​

新增 ​

  • Anthropic 兼容：/v1/messages 端点正式上线
  • Gemini 兼容：/v1beta/models/{model}:generateContent 端点上线
  • deepseek-v4-pro / deepseek-v4-flash 模型上线

改进 ​

  • API Key 支持设置 IP 白名单
  • 控制台新增用量监控仪表盘
  • 流式响应 SSE 格式完全对齐 OpenAI

修复 ​

  • 修复 glm-5.1 图像输入解析失败
  • 修复 temperature=0 时偶发空响应问题

v138 (2026-05-20) ​

新增 ​

  • 图像生成 API：正式发布，支持 dall-e-3 / dall-e-2 / midjourney / seedream / flux 系列
  • 音频 API：TTS / ASR 正式发布
  • minimax-m3 / qwen3.7-plus / doubao 系列模型上线

改进 ​

  • glm-5.2 上下文从 128K 提升至 1M
  • 响应头新增 X-RateLimit-* 限流信息
  • 错误响应格式对齐 OpenAI

v137 (2026-04-10) ​

新增 ​

  • 宁享Token API 正式上线
  • Chat Completions API：支持 glm-5.2 / glm-5.1
  • Embeddings API：支持 text-embedding-3-large / text-embedding-3-small
  • 模型列表 API：GET /v1/models
  • 用户信息 API：余额查询、用量记录、密钥管理

变更类型说明 ​

类型说明
新增新功能 / 新端点 / 新模型
改进既有功能优化
修复Bug 修复
废弃即将下线，建议迁移
下线已移除

兼容性政策 ​

  • API 版本：本页记录的最新版本为 v167，向后兼容
  • 废弃通知：废弃功能至少提前 30 天通知
  • 下线周期：废弃后至少 90 天才下线
  • 变更通知：重大变更通过控制台公告和邮件通知

反馈 ​

如有 API 相关问题，请通过控制台提交工单。

© 2026 宁享Token. 保留所有权利。

南京宁澜信息科技有限公司 苏ICP备2026045897号