Sync latest model docs from BAI-docs - #47
Conversation
Code Review ReportProject: Bank of AI — Documentation Site PR OverviewBranch Information
Commit History
Review SummaryVerdict
Findings at a Glance
SummaryThis PR adds documentation for three newly launched AI models — DeepSeek V4 Flash, DeepSeek V4 Pro, and GPT-5.5 — to the Bank of AI LLM Service documentation site. Each model receives a new English page, a Chinese (zh-Hans) translation, an entry in the master pricing table, and a sidebar registration in Overall content quality is solid: the new pages are well-structured, use consistent Markdown formatting within themselves, and correctly parallel the site's established page layout. The zh-Hans translations appear accurate and complete. One Major issue requires attention before merge: GPT-5.5 has important tiered pricing beyond 272K input tokens (2× rate) that is correctly documented on the model-specific page but is absent from the Change Summary1. New English Model Pages (3 new files)
Purpose: Surface newly released (April 2026) model documentation so platform users can evaluate model capabilities and pricing before selecting a model. 2. Chinese (zh-Hans) Translations (3 new + 1 modified files)
Purpose: Keep English and Chinese documentation in parity for the three new models. 3. Pricing Table & Sidebar Updates (2 modified files)
Purpose: Make the new pages discoverable via site navigation and surfaced in the pricing reference table. Detailed FindingsMajor[MJ-01] GPT-5.5 Tiered Pricing Note Missing from Master Pricing Table
Description
Code # pricing-and-usage.md (master table — what was added)
+| GPT-5.5 | 5.00 | 30.00 | - |
# gpt-5-5.md (model page — correctly documents the surcharge)
| **GPT-5.5** | `5.00` | `30.00` | 2x input / 1.5x output beyond 272K tokens |Recommendation Update the Notes column in the master pricing table to surface the tiered rate, consistent with the model page: | GPT-5.5 | 5.00 | 30.00 | 2× input beyond 272K tokens |The same correction should be applied to the zh-Hans pricing table: | GPT-5.5 | 5.00 | 30.00 | 超过 272K 输入按 2 倍计费 |Minor[MN-01] Inconsistent Pricing Units Across Model-Specific Pages
Description
Code # New docs (Credits/Token) — correct match to pricing-and-usage.md
| **DeepSeek V4 Flash** | `0.14` | `0.28` | 1M context, 384K max output |
# deepseek-v3.2.md (Credits/1K Tokens) — older convention
| **DeepSeek-V3.2** | `0.27` | `0.42` | ← table header: Credits/1K Tokens
# gpt-5-4.md ($ per 1M tokens) — yet another convention
| GPT-5.4 | $2.50 | $15.00 | ← table header: per 1M tokensRecommendation
[MN-02] Knowledge Cutoff Date Missing from New Model Capability Tables
Description
Code # gpt-5-4.md — has this row (existing standard)
| **Knowledge Cutoff** | August 31, 2025 |
# gpt-5-5.md — missing this row entirely
| **Tool Use** | Full function calling, tool search, ... |
| **Multilingual** | Broad multilingual support ... |
# No Knowledge Cutoff rowRecommendation
[MN-03] DeepSeek Multilingual Description Drops "Chinese" in zh-Hans Translation
Description
Code # English (docs/llmservice/models/deepseek-v4-flash.md)
| **Multilingual** | Broad multilingual support; strongest in English and Chinese |
# zh-Hans translation — "Chinese" omitted
| **多语言能力** | 广泛支持多语言，其中英文表现最强 |Recommendation
[MN-04] DeepSeek Model Pages Lack Source References
Description
Code # gpt-5-5.md — has references (good practice)
## References
[1] [OpenAI GPT-5.5 Announcement](https://openai.com/index/gpt-5-5)
[2] [OpenAI API Pricing](https://openai.com/api/pricing)
# deepseek-v4-pro.md — ends without references
| **DeepSeek V4 Pro** | `1.74` | `3.48` | 1M context, 384K max output |
# EOF — no references sectionRecommendation
[MN-05] References to "Claude Opus 4.7" — Model Not Listed on the Platform
Description
Code # deepseek-v4-pro.md — Line 7
...roughly 1/20th the price of Claude Opus 4.7.
# gpt-5-5.md — Known Limitations, Line ~45
Lost the harder SWE-Bench Pro benchmark to Claude Opus 4.7 despite winning the
standard SWE-Bench Verified headline.Recommendation
Suggestions[S-01] DeepSeek Model Pages Could Adopt Section Emoji Style Matching deepseek-v3.2.mdFile: [S-02] Explicitly Document Web Search Support Status in Model Capability TablesFile: [S-03] Add a "Release Date" Row to Capability TablesFile: All three new model pages Positive Observations
Checklist Results
DisclaimerThis is an automated code review. It supplements but does not replace human review. The reviewer analyzed only the diff between the specified branches ( Report generated by Code Review Skill v1.0.0 |
Code Review ReportProject: x402-tron / BANK OF AI Docs PR OverviewBranch Information
Commit History
Review SummaryVerdict
Findings at a Glance
SummaryThis PR adds documentation pages for three newly-launched LLM models — GPT-5.5, DeepSeek V4 Pro, and DeepSeek V4 Flash — across both the English and Chinese (zh-Hans) locales. It registers each model in the navigation sidebars, updates the global pricing-and-usage table, and bumps the package version from One Major issue requires a fix before merging: the global pricing page omits GPT-5.5's long-context tiered surcharge (2x input / 1.5x output beyond 272K tokens), which is a significant billing detail that users relying on the pricing table alone will miss. Three Minor issues cover a missing H1 title in the GPT-5.5 document (both locales), a numerical inconsistency in the GPT-5.5 overview text, and a vague commit message. Four Suggestions address consistency improvements and user-experience enhancements. Change Summary1. New Model Documentation — English (
|
| File | Change Type | Description |
|---|---|---|
docs/llmservice/models/gpt-5-5.md |
Added | GPT-5.5 model page: overview, key features, use cases, capabilities table, pricing |
docs/llmservice/models/deepseek-v4-pro.md |
Added | DeepSeek V4 Pro model page: MoE architecture, coding benchmarks, tool-use, pricing |
docs/llmservice/models/deepseek-v4-flash.md |
Added | DeepSeek V4 Flash model page: efficient 13B-active-param variant, pricing |
Purpose: Expose newly-released model options to English-speaking users.
2. New Model Documentation — Chinese (i18n/zh-Hans/docusaurus-plugin-content-docs/current/llmservice/models/)
| File | Change Type | Description |
|---|---|---|
.../models/gpt-5-5.md |
Added | Simplified Chinese translation of the GPT-5.5 model page |
.../models/deepseek-v4-pro.md |
Added | Simplified Chinese translation of the DeepSeek V4 Pro page |
.../models/deepseek-v4-flash.md |
Added | Simplified Chinese translation of the DeepSeek V4 Flash page |
Purpose: Localise new model documentation for Chinese-speaking users.
3. Pricing Table Updates
| File | Change Type | Description |
|---|---|---|
docs/llmservice/pricing-and-usage.md |
Modified | Added 3 new rows: DeepSeek V4 Flash, DeepSeek V4 Pro, GPT-5.5 |
i18n/zh-Hans/.../llmservice/pricing-and-usage.md |
Modified | Same 3 rows added to the Chinese pricing table |
Purpose: Keep the central pricing reference up to date.
4. Sidebar Navigation Registration
| File | Change Type | Description |
|---|---|---|
sidebars.js |
Modified | Added gpt-5-5, deepseek-v4-pro, deepseek-v4-flash to the Models list |
i18n/zh-Hans/.../sidebars.js |
Modified | Same 3 IDs added to the Chinese sidebar |
Purpose: Make new model pages discoverable via the site navigation.
5. Package Version Bump
| File | Change Type | Description |
|---|---|---|
package.json |
Modified | Version 1.2.12 → 1.2.13 |
Purpose: Reflect the documentation content addition in the package version.
Detailed Findings
Major
[MJ-01] GPT-5.5 Long-Context Surcharge Not Surfaced in Global Pricing Table
| Property | Value |
|---|---|
| Severity | Major |
| Category | Documentation / Correctness |
| File | docs/llmservice/pricing-and-usage.md : Lines 13-35 · i18n/zh-Hans/.../pricing-and-usage.md : Lines 13-35 |
Description
GPT-5.5 has a tiered pricing model: input tokens beyond 272K are billed at 2x and output tokens beyond 272K at 1.5x the base rate. This billing caveat is documented in
docs/llmservice/models/gpt-5-5.md(pricing tableNotescolumn and Known Limitations) and in the Chinese model page. However, the global pricing reference (pricing-and-usage.md) — the page most users will consult first to estimate costs — has noNotescolumn and therefore completely omits this surcharge. A user who reads only the pricing table will see5.00 / 30.00 Credits/Tokenand have no indication that long-context requests can cost double. This could lead to significant unexpected charges for users running large-context workloads.
Code
<!-- docs/llmservice/pricing-and-usage.md — current diff addition -->
| GPT-5.5 | 5.00 | 30.00 | - |<!-- gpt-5-5.md — pricing table shows the caveat, but only on the model detail page -->
| **GPT-5.5** | `5.00` | `30.00` | 2x input / 1.5x output beyond 272K tokens |Recommendation
Add a Notes column (or a * footnote) to the global pricing table for GPT-5.5 to surface the long-context surcharge. For example:
| Model | Input (Credits/Token) | Output (Credits/Token) | Web Search (Credits/Use) | Notes |
| :---------------- | --------------------: | ---------------------: | -----------------------: | :----------------------------------------- |
| ... | | | | |
| GPT-5.5 | 5.00 | 30.00 | - | 2× input / 1.5× output beyond 272K tokens |Apply the same fix to i18n/zh-Hans/.../pricing-and-usage.md.
Minor
[MN-01] GPT-5.5 Document Missing H1 Title (Both Locales)
| Property | Value |
|---|---|
| Severity | Minor |
| Category | Documentation / Code Quality |
| File | docs/llmservice/models/gpt-5-5.md : Line 1 · i18n/zh-Hans/.../models/gpt-5-5.md : Line 1 |
Description
Every other model documentation file in this repository begins with an H1 heading (
# ModelName). The newgpt-5-5.md(both English and Chinese variants) starts directly with## Overview/## 概述, skipping the H1. In Docusaurus, the H1 is typically used as the document's page title in the browser tab and as the breadcrumb label. Without it, the page will either inherit the sidebar label as title or render with no H1 at all, breaking visual consistency with peer pages.
Code
<!-- docs/llmservice/models/gpt-5-5.md — line 1 -->
## Overview ← should be preceded by # GPT-5.5
<!-- All other model pages for reference -->
# DeepSeek V4 Pro ← deepseek-v4-pro.md line 1
# DeepSeek V4 Flash ← deepseek-v4-flash.md line 1Recommendation
Add the H1 title as the first line of both files:
# GPT-5.5
## Overview
...<!-- zh-Hans version -->
# GPT-5.5
## 概述
...[MN-02] GPT-5.5 Overview States "1-Million-Token Context" but Capabilities Table Shows 1,050,000 Tokens
| Property | Value |
|---|---|
| Severity | Minor |
| Category | Documentation / Correctness |
| File | docs/llmservice/models/gpt-5-5.md : Line 3 vs Line 26 · i18n/zh-Hans/.../models/gpt-5-5.md : Line 3 vs Line 26 |
Description
The Overview paragraph describes GPT-5.5 as having "a 1-million-token context window," while the Capabilities table on the same page shows the actual value as
1,050,000 tokens. The same discrepancy appears in the Chinese translation. This is a minor factual inconsistency within the document itself — the rounded figure in prose is marketing shorthand, but readers who cross-reference these two sections may find the numbers confusing. The gpt-5-5.mdKnown Limitationssection correctly names1,050,000 tokensas a key detail (the pricing break at 272K).
Code
<!-- Line 3 — Overview -->
GPT-5.5 features a natively omnimodal architecture, a 1-million-token context window...
<!-- Line 26 — Capabilities table -->
| **Context Window** | 1,050,000 tokens (2x pricing for input beyond 272K tokens) |Recommendation
Align the overview text with the precise figure:
GPT-5.5 features a natively omnimodal architecture, a 1,050,000-token context window...Or keep the shorthand and add a parenthetical:
...a ~1-million-token context window (1,050,000 tokens)...Apply the same fix to the Chinese translation.
[MN-03] Uninformative Commit Message
| Property | Value |
|---|---|
| Severity | Minor |
| Category | Code Quality |
| File | Commit 4a1c769 |
Description
The second commit is titled simply
update. This is a one-word message that provides no information about what was changed. Even for a documentation project, commit history is used for tracing changes, changelogs, and automated release notes. The companion commitc198cb6 Sync new model docs from BAI-docsis well-written;4a1c769should follow the same standard.
Recommendation
Amend the commit message (or ensure future commits follow a descriptive convention):
docs: add GPT-5.5, DeepSeek V4 Pro/Flash to pricing table and sidebars
Suggestions
[S-01] Clarify Flash-Max Mode Billing Status in DeepSeek V4 Flash Docs
File: docs/llmservice/models/deepseek-v4-flash.md · i18n/zh-Hans/.../models/deepseek-v4-flash.md
Description: The document mentions "V4-Flash-Max" as a reasoning mode activated with a larger thinking budget, and notes it may "increase latency and cost for complex tasks." It's unclear whether Flash-Max is a separate model ID with its own pricing on the platform, or simply a prompt configuration. Users may try to select it as a model and be confused when it doesn't appear.
Suggestion: Add a brief clarification, e.g., "Flash-Max is not a separate model tier on this platform — it refers to providing a larger thinking budget via prompt configuration within the same V4 Flash model."
[S-02] Add Knowledge Cutoff Field to New Model Docs for Consistency
File: docs/llmservice/models/gpt-5-5.md, deepseek-v4-pro.md, deepseek-v4-flash.md (and zh-Hans equivalents)
Description: The existing gpt-5-4.md capabilities table includes a Knowledge Cutoff row (August 31, 2025). None of the three new model pages include this field, which is practically useful for users doing knowledge-intensive tasks.
Suggestion: Add a Knowledge Cutoff row to the Capabilities table in each new model document, or explicitly state "Not disclosed" if unknown.
[S-03] Add Official Source References to DeepSeek V4 Model Pages
File: docs/llmservice/models/deepseek-v4-pro.md, docs/llmservice/models/deepseek-v4-flash.md
Description: The gpt-5-5.md page includes a ## References section with links to the official OpenAI announcement and pricing page. The two new DeepSeek pages contain no references. Authoritative source links help users verify benchmarks and technical claims independently.
Suggestion: Add a references section:
## References
[1] [DeepSeek V4 Announcement](https://deepseek.com/blog/deepseek-v4)
[2] [DeepSeek API Pricing](https://platform.deepseek.com/pricing)[S-04] Pricing Table — Consider Adding a "Notes" Column for Tier/Limit Context
File: docs/llmservice/pricing-and-usage.md · i18n/zh-Hans/.../pricing-and-usage.md
Description: The current pricing table has only three columns: Input, Output, Web Search. As more models with non-linear pricing (long-context multipliers, minimum spend thresholds) are added, important billing details get buried in per-model pages. This is already an issue for GPT-5.5 (addressed in MJ-01) and could affect future additions.
Suggestion: Add an optional Notes column to the pricing table and populate it with the most important billing caveat for each model (e.g., long-context multipliers, free-tier limits). Models with no special conditions can be marked -.
Positive Observations
| Area | Observation |
|---|---|
| Localization completeness | All three new model pages are fully translated into Simplified Chinese with accurate benchmark figures, consistent with the English source. |
| Pricing consistency | Credit values are identical across the model detail pages (gpt-5-5.md, deepseek-v4-pro.md, deepseek-v4-flash.md) and the global pricing-and-usage.md tables in both locales. No numerical discrepancies found. |
| Sidebar symmetry | Both sidebars.js and the zh-Hans sidebars.js are updated in sync — the same three model IDs added in the same relative order in both files. |
| Benchmark accuracy | The computed 12.4x cost ratio for DeepSeek V4 Flash vs V4 Pro (1.74 / 0.14 = 12.43×) is correctly stated. The stated SWE-bench gap of 1.6 percentage points between Flash (79.0%) and Pro (80.6%) is also accurate. |
| Structured content | New model docs follow a consistent template (Overview → Key Features → Best Use Cases → Capabilities table → Known Limitations → Credits and Pricing), making them easy to scan and compare. |
| Version bump | The package.json version is incremented appropriately (1.2.12 → 1.2.13) to reflect the content addition. |
Checklist Results
| Category | Items Checked | Pass | Fail | N/A | Notes |
|---|---|---|---|---|---|
| Correctness | 5 | 4 | 1 | 3 | Pricing surcharge omission in global table (MJ-01); context window figure inconsistency (MN-02) |
| Security | 8 | — | — | 8 | Documentation-only PR; no code, credentials, or user input |
| Performance | 7 | — | — | 7 | Documentation-only PR |
| Code Quality | 6 | 4 | 2 | 2 | Missing H1 in GPT-5.5 docs (MN-01); uninformative commit message (MN-03) |
| Testing | 7 | — | — | 7 | No functional code changes requiring tests |
| Documentation | 6 | 4 | 2 | 0 | Long-context surcharge absent from pricing table (MJ-01); knowledge cutoff and references missing (S-02, S-03) |
| Compatibility | 5 | 5 | 0 | 0 | Sidebar IDs follow existing naming convention; no breaking changes |
| Observability | 4 | — | — | 4 | Documentation-only PR |
Disclaimer
This is an automated code review. It supplements but does not replace human review. The reviewer analyzed only the diff between main and ai-bankofai-patch-1. Factual accuracy of third-party benchmark scores and model specifications is taken as provided by the author; independent verification against primary sources is recommended for benchmark claims.
Report generated by Code Review Skill v1.0.0
Date: 2026-04-28
3 participants
This PR syncs the latest LLM documentation updates from
BAI-labs/BAI-docsintoBofAI/docs.Included updates:
GPT-5.5DeepSeek V4 FlashDeepSeek V4 Propricing-and-usagepages with the new model pricingsidebars.jsto include the new model entries under LLM ServiceSynced model pricing:
Validation:
yarn buildcompleted successfully