Changelog

This release introduces comprehensive support for tiered billing (阶梯计费). It allows for flexible pricing expressions, detailed tool call quota calculations, and channel test support for tiered models. 本次发布重点增加了对阶梯计费的全面支持，支持灵活的计费表达式解析、自定义工具调用额度计算，并完善了UI配置项和渠道测试支持。

Docker image: calciumion/new-api:nightly Docker 镜像: calciumion/new-api:nightly

New Features

Added comprehensive support for tiered billing, including flexible expression evaluation, tool pricing settings UI, and channel test support (#4145).
Added custom fields support for vllm-omini models (#4154).

Bug Fixes

Fixed an issue in Alibaba Cloud task polling to correctly accept string usage values (#4155).
Fixed the endpoint for Zhipu 4v coding plan image generation (#4146).
Fixed pricing calculation to prefer explicit pricing for compact models (#4156).

Improvements

Improved UI layout consistency by replacing card components with divs.
Added nightly branch trigger to Docker image CI workflows.
Refined PR templates and added PR submission checks (#4076).

What's Changed

fix(zhipu_4v): use correct endpoint for coding plan image generation by @NyaMisty in https://github.com/QuantumNous/new-api/pull/4146
fix: prefer explicit pricing for compact models by @seefs001 in https://github.com/QuantumNous/new-api/pull/4156
fix(ali): accept string usage values in task polling by @seefs001 in https://github.com/QuantumNous/new-api/pull/4155
feat: fill in some custom fields for vllm-omini by @seefs001 in https://github.com/QuantumNous/new-api/pull/4154
fix: document render by @seefs001 in https://github.com/QuantumNous/new-api/pull/4153
ci: refine PR template and add PR submission checks by @seefs001 in https://github.com/QuantumNous/new-api/pull/4076
fix(channel-test): support tiered billing model tests by @yyhhyyyyyy in https://github.com/QuantumNous/new-api/pull/4145

New Contributors

@NyaMisty made their first contribution in https://github.com/QuantumNous/new-api/pull/4146

Full Changelog: https://github.com/QuantumNous/new-api/compare/v0.12.5...nightly-20260409

Download Resources

v0.12.5

Release · Published at 2026-04-08 17:13:32 (UTC+8)

New Features

Add support for Minimax image generation relay (#4103).

Improvements

Redesign group ratio rules with a collapsible layout for better usability.
Enhance dashboard chart axes and sorting logic.
Add a convenient copy button next to the API link in the dashboard info panel.

Bug Fixes

Resolve email delivery issues for Outlook and similar providers (#4112).

What's Changed

feat: 支持强制使用 AUTH LOGIN 以解决 outlook 等邮箱的发件问题 by @Hoshino-Yumetsuki in https://github.com/QuantumNous/new-api/pull/4112
feat(minimax): add image generation relay support by @forsakenyang in https://github.com/QuantumNous/new-api/pull/4103

New Contributors

@Hoshino-Yumetsuki made their first contribution in https://github.com/QuantumNous/new-api/pull/4112
@forsakenyang made their first contribution in https://github.com/QuantumNous/new-api/pull/4103

Full Changelog: https://github.com/QuantumNous/new-api/compare/v0.12.4...v0.12.5

Download Resources

v0.12.4

Release · Published at 2026-04-08 15:49:44 (UTC+8)

New Features

Added an IncludeModelName option to channel affinity rules for per-model affinity tracking (#3488)
Added an ErrorBoundary component to the web UI to prevent full-page crashes (#3350)
Added support for Duration in TaskSubmitReq (#4068)
Added admin user analytics to the dashboard

Bug Fixes

Fixed pricing filtering based on usable groups (#4123)
Fixed an issue where Claude streaming interruptions incorrectly overwrote usage data instead of preserving cache billing fields (#4128)
Fixed an issue where the "do not retry after failure" configuration was incorrectly overwritten in memory (#4142)

Improvements

Added support for enabling error logging via environment variables (#4131)
Wrapped scope tag labels with t() for better i18n support
Fixed chart labels on the dashboard

What's Changed

feat: add IncludeModelName option to channel affinity rules by @clansty in https://github.com/QuantumNous/new-api/pull/3488
feat: add ErrorBoundary to prevent full-page crashes by @goodmorning10 in https://github.com/QuantumNous/new-api/pull/3350
fix: Claude 流式断流时不再整份覆盖 usage，保留 cache 计费字段 by @zuiho-kai in https://github.com/QuantumNous/new-api/pull/4128
fix(pricing): add filtering for pricing based on usable groups by @bbbugg in https://github.com/QuantumNous/new-api/pull/4123
chore(deps): bump github.com/aws/aws-sdk-go-v2/service/bedrockruntime from 1.50.0 to 1.50.4 by @dependabot[bot] in https://github.com/QuantumNous/new-api/pull/4136
add 添加启用错误日志记录到env配置中 by @binorxin in https://github.com/QuantumNous/new-api/pull/4131
Seedance support duration by @feitianbubu in https://github.com/QuantumNous/new-api/pull/4068
fix: 修复失败后不重试配置项写到内存被覆盖 by @seefs001 in https://github.com/QuantumNous/new-api/pull/4142

New Contributors

@clansty made their first contribution in https://github.com/QuantumNous/new-api/pull/3488
@goodmorning10 made their first contribution in https://github.com/QuantumNous/new-api/pull/3350
@zuiho-kai made their first contribution in https://github.com/QuantumNous/new-api/pull/4128
@bbbugg made their first contribution in https://github.com/QuantumNous/new-api/pull/4123

Full Changelog: https://github.com/QuantumNous/new-api/compare/v0.12.3...v0.12.4

Download Resources

v0.12.3

Release · Published at 2026-04-08 01:04:04 (UTC+8)

This is a small polish release focused on making configuration easier to navigate by simplifying the settings layout and consolidating model pricing controls.

Improvements

Refined the settings interface with a unified model pricing view and a cleaner tab structure to make configuration easier to navigate.

What's Changed

feat(token): add batch API for fetching token keys by @RedwindA in https://github.com/QuantumNous/new-api/pull/4114

Full Changelog: https://github.com/QuantumNous/new-api/compare/v0.12.2...v0.12.3

Download Resources

v0.12.2

Release · Published at 2026-04-06 18:10:52 (UTC+8)

New Features

Add support for PDF conversion between OpenAI and Claude APIs.
Support differential billing for Seedance 2.0 based on video vs. no-video input.
Enhance max_tokens handling and input sanitization in the playground (#4106).
Enhance stream status display with error tooltips in usage logs.

Bug Fixes

Fix usage calculation issues when converting between Claude and OpenAI APIs by emitting message_delta for the final stream chunk (#4090).
Fix Gemini stream detection by checking the :streamGenerateContent URL path (#4087).
Fix Claude request requirements by properly setting TopP to nil.

Improvements

Unify file source creation and enhance caching mechanisms.

What's Changed

fix(gemini): detect streaming from URL path :streamGenerateContent by @D26FORWARD in https://github.com/QuantumNous/new-api/pull/4087
fix: emit claude message_delta for usage-only final stream chunk by @seefs001 in https://github.com/QuantumNous/new-api/pull/4090
chore(deps-dev): bump electron from 35.7.5 to 39.8.5 in /electron by @dependabot[bot] in https://github.com/QuantumNous/new-api/pull/4080
chore(deps-dev): bump @xmldom/xmldom from 0.8.11 to 0.8.12 in /electron by @dependabot[bot] in https://github.com/QuantumNous/new-api/pull/3523
chore(deps-dev): bump lodash from 4.17.23 to 4.18.1 in /electron by @dependabot[bot] in https://github.com/QuantumNous/new-api/pull/4097
feat(playground): enhance max_tokens handling and input sanitization by @HynoR in https://github.com/QuantumNous/new-api/pull/4106

New Contributors

@D26FORWARD made their first contribution in https://github.com/QuantumNous/new-api/pull/4087

Full Changelog: https://github.com/QuantumNous/new-api/compare/v0.12.1...v0.12.2

Download Resources

v0.12.1

Release · Published at 2026-04-02 22:01:41 (UTC+8)

This release adds Seedance 2.0 video support and broadens media compatibility across providers. It also makes failures easier to understand with clearer Seedance and performance-related error messages.

New Features

Added Seedance 2.0 video generation API support with duration control in seconds, clearer failure reporting, and better prompt handling for single-text requests (#4042).
Added HEIC/HEIF image support, including Gemini channel compatibility and more reliable handling of HEIF images (#4049).
Added basic inline file support for Claude relay so compatible requests can include media directly (#3505).

Improvements

Improved performance-related error messages to make request failures easier to understand.

What's Changed

fix: add basic inline file support for Claude relay by @seefs001 in https://github.com/QuantumNous/new-api/pull/3505
新增seedance2.0视频接口支持 by @feitianbubu in https://github.com/QuantumNous/new-api/pull/4042
feat: add HEIC/HEIF image format support for Gemini channel by @RedwindA in https://github.com/QuantumNous/new-api/pull/4049

Full Changelog: https://github.com/QuantumNous/new-api/compare/v0.12.0...v0.12.1

Download Resources

v0.12.0

Release · Published at 2026-04-02 00:22:05 (UTC+8)

v0.12.0 adds Wan 2.7 image generation support and streamlines channel setup in the admin UI. It also improves billing accuracy and fixes several model and dashboard issues.

New Features

Added support for Wan 2.7 image generation, including control over how many images are generated per request (#3526).

Bug Fixes

Fixed image-generation billing and usage statistics so request counts and costs are reported more accurately without double-counting (#3512).
Fixed a UI issue that caused the consumption distribution chart to make the page scrollbar flicker on hover (#3474).
Fixed xAI Grok-3-mini compatibility when no completion token limit is set, reducing failed requests.

Improvements

Made channel setup faster and smoother by letting you create a channel from a copied token, remembering advanced settings in the edit dialog, and improving clipboard handling.

What's Changed

fix(dashboard): 修复消耗分布图表悬浮时滚动条闪烁 by @wans10 in https://github.com/QuantumNous/new-api/pull/3474
docs(zh-TW): fix missing content and add partner logo by @DaZuiZui in https://github.com/QuantumNous/new-api/pull/3462
chore(deps-dev): bump picomatch from 4.0.3 to 4.0.4 in /electron by @dependabot[bot] in https://github.com/QuantumNous/new-api/pull/3450
fix: prevent double-counting of image count n in billing by @imlhb in https://github.com/QuantumNous/new-api/pull/3512
支持wan2.7生图-wan2.7-image by @feitianbubu in https://github.com/QuantumNous/new-api/pull/3526

New Contributors

@DaZuiZui made their first contribution in https://github.com/QuantumNous/new-api/pull/3462
@imlhb made their first contribution in https://github.com/QuantumNous/new-api/pull/3512

Full Changelog: https://github.com/QuantumNous/new-api/compare/v0.11.9...v0.12.0

Download Resources

v0.12.0-alpha.2

Release · Published at 2026-03-31 21:43:12 (UTC+8)

Release Highlights

This release includes minor improvements to the EditChannelModal component to enhance clipboard handling reliability.

Bug Fixes

EditChannelModal: Enhance clipboard handling with error checks (670abee)

Full Changelog: https://github.com/QuantumNous/new-api/compare/v0.12.0-alpha.1...v0.12.0-alpha.2

Download Resources

v0.12.0-alpha.1

Release · Published at 2026-03-31 19:40:48 (UTC+8)

Highlights

This release introduces a new clipboard magic string feature for quick channel creation and includes important security and UI improvements.

New Features

Add clipboard magic string for quick channel creation from token copy

Bug Fixes

修复消耗分布图表悬浮时滚动条闪烁 (Fix dashboard scrollbar flickering) (#3474)
Fix xAI MaxTokens mapping for grok-3-mini model

Improvements

Security improvements
Enhance footer layout and styling
Update Traditional Chinese README with missing content and partner logo (#3462)
Refactor account binding endpoints to use POST and normalize reset responses

What's Changed

fix(dashboard): 修复消耗分布图表悬浮时滚动条闪烁 by @wans10 in https://github.com/QuantumNous/new-api/pull/3474
docs(zh-TW): fix missing content and add partner logo by @DaZuiZui in https://github.com/QuantumNous/new-api/pull/3462

New Contributors

@DaZuiZui made their first contribution in https://github.com/QuantumNous/new-api/pull/3462

Full Changelog: https://github.com/QuantumNous/new-api/compare/v0.11.9...v0.12.0-alpha.1

Download Resources

v0.11.9

Release · Published at 2026-03-31 17:07:05 (UTC+8)

Release Notes for v0.11.9

New Features

Add slide-in animations and update translations for new UI elements
Prevent metadata from overriding model fields (#3461)
Record stream interruption reasons via StreamStatus
Expose i18n instance to the global window object for easier access

Bug Fixes

Restore pre-3400 OpenRouter billing semantics (#3438)
Restore doubao coding plan deprecation and regex ignored models lost during conflict resolution
Preserve cache usage in openai-to-claude response conversion

Improvements

Expose skip-retry option and show it in the rules list (#3440)
Harden Docker and release CI workflows to improve security

What's Changed

fix: restore pre-3400 OpenRouter billing semantics by @seefs001 in https://github.com/QuantumNous/new-api/pull/3438
refactor: expose skip-retry option and show it in rules list by @seefs001 in https://github.com/QuantumNous/new-api/pull/3440
feat: prevent metadata from overriding model fields by @feitianbubu in https://github.com/QuantumNous/new-api/pull/3461
chore(deps): bump golang.org/x/image from 0.23.0 to 0.38.0 by @dependabot[bot] in https://github.com/QuantumNous/new-api/pull/3507

Full Changelog: https://github.com/QuantumNous/new-api/compare/v0.11.9-alpha.1...v0.11.9

Download Resources

v0.11.9-alpha.1

Release · Published at 2026-03-23 15:40:30 (UTC+8)

What's Changed

fix: disable doubao coding plan selection by @seefs001 in https://github.com/QuantumNous/new-api/pull/3379
fix: oauth bind callback handling by @seefs001 in https://github.com/QuantumNous/new-api/pull/3393
feat: support regex-prefixed ignored upstream models by @seefs001 in https://github.com/QuantumNous/new-api/pull/3381
adjuct default settings by @seefs001 in https://github.com/QuantumNous/new-api/pull/3335
fix: honor channel affinity skip-retry when channel is disabled by @seefs001 in https://github.com/QuantumNous/new-api/pull/3333
fix: apply forced beta query at final upstream URL stage by @seefs001 in https://github.com/QuantumNous/new-api/pull/3331
Refactor/codex usage by @seefs001 in https://github.com/QuantumNous/new-api/pull/3399
refactor: optimize billing flow for OpenAI-to-Anthropic convert by @seefs001 in https://github.com/QuantumNous/new-api/pull/3400
fix: the "detail" field is empty, an empty field was sent to upstream by @seefs001 in https://github.com/QuantumNous/new-api/pull/3401

Full Changelog: https://github.com/QuantumNous/new-api/compare/v0.11.8...v0.11.9-alpha.1

Download Resources

v0.11.8

Release · Published at 2026-03-22 13:55:40 (UTC+8)

What's Changed

fix: normalize generic oauth bearer token type by @seefs001 in https://github.com/QuantumNous/new-api/pull/3359
feat: add server log file management to performance settings by @RedwindA in https://github.com/QuantumNous/new-api/pull/3369
feat: Add support for counting cache-hit tokens in llama.cpp by @wenyifancc in https://github.com/QuantumNous/new-api/pull/3357
docs: 完善宝塔面板部署教程并修复链接错误 by @lcq225 in https://github.com/QuantumNous/new-api/pull/3360

New Contributors

@wenyifancc made their first contribution in https://github.com/QuantumNous/new-api/pull/3357
@lcq225 made their first contribution in https://github.com/QuantumNous/new-api/pull/3360

Full Changelog: https://github.com/QuantumNous/new-api/compare/v0.11.7...v0.11.8

Download Resources

v0.11.7

Release · Published at 2026-03-19 16:15:24 (UTC+8)

What's Changed

chore: refine PR template by @seefs001 in https://github.com/QuantumNous/new-api/pull/3287
feat: 支持通过环境变量配置搜索接口限流参数 by @ywandy in https://github.com/QuantumNous/new-api/pull/3313
fix: 修正 Codex free 账号用量显示到每周窗口 by @Honghurumeng in https://github.com/QuantumNous/new-api/pull/3316
feat(waffo): Waffo payment gateway integration by @zhongyuanzhao-alt in https://github.com/QuantumNous/new-api/pull/3293
fix: redirect OAuth login in current page by @seefs001 in https://github.com/QuantumNous/new-api/pull/3329

New Contributors

@ywandy made their first contribution in https://github.com/QuantumNous/new-api/pull/3313
@Honghurumeng made their first contribution in https://github.com/QuantumNous/new-api/pull/3316
@zhongyuanzhao-alt made their first contribution in https://github.com/QuantumNous/new-api/pull/3293

Full Changelog: https://github.com/QuantumNous/new-api/compare/v0.11.6...v0.11.7

Download Resources

v0.11.6-patch.1

Release · Published at 2026-03-17 18:39:55 (UTC+8)

Download Resources

v0.11.6

Release · Published at 2026-03-17 17:23:40 (UTC+8)

参数覆盖记录到日志错误日志恢复tooltip显示

What's Changed

feat: params override log by @seefs001 in https://github.com/QuantumNous/new-api/pull/3285

Full Changelog: https://github.com/QuantumNous/new-api/compare/v0.11.5...v0.11.6

Download Resources

nightly-20260317

Release · Published at 2026-03-17 18:30:50 (UTC+8)

feat: implement tiered billing expression evaluation

Docker image: calciumion/new-api:nightly

Download Resources

v0.11.5

Release · Published at 2026-03-15 01:27:39 (UTC+8)

What's Changed

Round remaining balance by @KiGamji in https://github.com/QuantumNous/new-api/pull/3233
enhance channel key viewing by @seefs001 in https://github.com/QuantumNous/new-api/pull/3257

Full Changelog: https://github.com/QuantumNous/new-api/compare/v0.11.4...v0.11.5

Download Resources

v0.11.4-patch.1

Release · Published at 2026-03-14 15:31:42 (UTC+8)

Full Changelog: https://github.com/QuantumNous/new-api/compare/v0.11.4...v0.11.4-patch.1

Download Resources

v0.11.4

Release · Published at 2026-03-12 15:37:12 (UTC+8)

What's Changed

Feature/param override wildcard path by @seefs001 in https://github.com/QuantumNous/new-api/pull/3129
fix: fetch model add header passthrough rule key check by @feitianbubu in https://github.com/QuantumNous/new-api/pull/3130
feats: repair the thinking of claude to openrouter convert by @nekohy in https://github.com/QuantumNous/new-api/pull/3120
feat: kling cost quota support use FinalUnitDeduction as totalToken by @feitianbubu in https://github.com/QuantumNous/new-api/pull/2769
fix: If top_p is not provided, ignore it by @seefs001 in https://github.com/QuantumNous/new-api/pull/3141
fix(relay): skip retries for bad response body errors by @seefs001 in https://github.com/QuantumNous/new-api/pull/3151
为渠道参数覆盖可视化规则提供拖拽排序支持 by @somnifex in https://github.com/QuantumNous/new-api/pull/3166
fix: kling risk fail return openAIVideo error by @feitianbubu in https://github.com/QuantumNous/new-api/pull/3148
fix: add explicit docker-compose networks by @pigletfly in https://github.com/QuantumNous/new-api/pull/3147
feat：support $keep_only_declared and deduped $append for header override by @seefs001 in https://github.com/QuantumNous/new-api/pull/3182
chore: update model lists for frequently used channels by @RedwindA in https://github.com/QuantumNous/new-api/pull/3221

New Contributors

@pigletfly made their first contribution in https://github.com/QuantumNous/new-api/pull/3147

Full Changelog: https://github.com/QuantumNous/new-api/compare/v0.11.2...v0.11.4

Download Resources

v0.11.4-alpha.5

Release · Published at 2026-03-10 02:03:34 (UTC+8)

请求头覆盖新增追加功能

What's Changed

fix: kling risk fail return openAIVideo error by @feitianbubu in https://github.com/QuantumNous/new-api/pull/3148
fix: add explicit docker-compose networks by @pigletfly in https://github.com/QuantumNous/new-api/pull/3147
feat：support $keep_only_declared and deduped $append for header override by @seefs001 in https://github.com/QuantumNous/new-api/pull/3182

New Contributors

@pigletfly made their first contribution in https://github.com/QuantumNous/new-api/pull/3147

Full Changelog: https://github.com/QuantumNous/new-api/compare/v0.11.4-alpha.4...v0.11.4-alpha.5

Download Resources

v0.11.4-alpha.4

Release · Published at 2026-03-08 22:42:27 (UTC+8)

为渠道参数覆盖可视化规则提供拖拽排序支持后端Token相关API变更

What's Changed

为渠道参数覆盖可视化规则提供拖拽排序支持 by @somnifex in https://github.com/QuantumNous/new-api/pull/3166

Full Changelog: https://github.com/QuantumNous/new-api/compare/v0.11.4-alpha.3...v0.11.4-alpha.4

Download Resources

v0.11.4-alpha.3

Release · Published at 2026-03-07 00:25:57 (UTC+8)

Main Changes

重构日志价格显示，默认隐藏倍率逻辑，可在列设置中切换 Refactor the log price display: hide the multiplier logic by default, with an option to toggle it in the column settings.

Full Changelog: https://github.com/QuantumNous/new-api/compare/v0.11.4-alpha.2...v0.11.4-alpha.3

Download Resources

v0.11.4-alpha.2

Release · Published at 2026-03-06 22:36:18 (UTC+8)

Main Changes

模型广场增加缓存等价格显示 Unify pricing labels and expand marketplace pricing display

Full Changelog: https://github.com/QuantumNous/new-api/compare/v0.11.4-alpha.1...v0.11.4-alpha.2

Download Resources

v0.11.4-alpha.1

Release · Published at 2026-03-06 21:38:47 (UTC+8)

Main Changes

完善可视化价格设置，为后续阶梯定价的开发做准备 Improve the visual pricing settings to prepare for subsequent development of tiered pricing.

What's Changed

fix(relay): skip retries for bad response body errors by @seefs001 in https://github.com/QuantumNous/new-api/pull/3151

Full Changelog: https://github.com/QuantumNous/new-api/compare/v0.11.2-patch.2...v0.11.4-alpha.1

Download Resources

v0.11.3-alpha.1

Release · Published at 2026-03-06 17:52:47 (UTC+8)

优化kling模型计费

What's Changed

feat: kling cost quota support use FinalUnitDeduction as totalToken by @feitianbubu in https://github.com/QuantumNous/new-api/pull/2769
fix: If top_p is not provided, ignore it by @seefs001 in https://github.com/QuantumNous/new-api/pull/3141

Full Changelog: https://github.com/QuantumNous/new-api/compare/v0.11.2-patch.1...v0.11.2-patch.2

Download Resources