docs: add model credit consumption guide (zh/en/ja) (#978)

* docs: add model credit consumption guide (zh/en/ja)

Add a new "Credits" sidebar section with model pricing documentation
covering all 9 Nexu Official models, including per-conversation cost
estimates and a rate multiplier relative to the default model
(gemini-3-flash-preview). Move the "earn credits by sharing" page
into the new section for better discoverability.

Made-with: Cursor

* docs: explain what the rate multiplier means

Made-with: Cursor

Author: qiongyu1999

docs/.vitepress/config.ts

@@ -129,6 +129,13 @@ const enSidebar = [
       { text: "Seedance 2.0 Video Generation", link: "/guide/seedance" },
     ],
   },
+  {
+    text: "Credits",
+    items: [
+      { text: "Model Credit Consumption", link: "/guide/model-pricing" },
+      { text: "Earn Credits by Sharing", link: "/guide/rewards" },
+    ],
+  },
   {
     text: "Help",
     items: [
@@ -142,7 +149,6 @@ const enSidebar = [
       { text: "Contributing", link: "/guide/contributing" },
       { text: "Contact Us", link: "/guide/contact" },
       { text: "Star Us on GitHub", link: "/guide/star" },
-      { text: "Earn Points by Sharing", link: "/guide/rewards" },
       { text: "Changelog", link: "https://github.com/nexu-io/nexu/releases" },
     ],
   },
@@ -179,6 +185,13 @@ const jaSidebar = [
       { text: "Seedance 2.0 動画生成", link: "/ja/guide/seedance" },
     ],
   },
+  {
+    text: "ポイント",
+    items: [
+      { text: "モデルのポイント消費", link: "/ja/guide/model-pricing" },
+      { text: "シェアしてポイント獲得", link: "/ja/guide/rewards" },
+    ],
+  },
   {
     text: "ヘルプ",
     items: [
@@ -192,7 +205,6 @@ const jaSidebar = [
       { text: "コントリビュート", link: "/ja/guide/contributing" },
       { text: "お問い合わせ", link: "/ja/guide/contact" },
       { text: "GitHub で Star", link: "/ja/guide/star" },
-      { text: "シェアでポイント獲得", link: "/ja/guide/rewards" },
       { text: "更新ログ", link: "https://github.com/nexu-io/nexu/releases" },
     ],
   },
@@ -231,6 +243,13 @@ const zhSidebar = [
       { text: "Seedance 2.0 视频生成（Windows 版）", link: "/zh/guide/seedance-windows" },
     ],
   },
+  {
+    text: "积分",
+    items: [
+      { text: "模型积分消耗说明", link: "/zh/guide/model-pricing" },
+      { text: "分享赚积分", link: "/zh/guide/rewards" },
+    ],
+  },
   {
     text: "帮助",
     items: [
@@ -245,7 +264,6 @@ const zhSidebar = [
       { text: "参与贡献", link: "/zh/guide/contributing" },
       { text: "联系我们", link: "/zh/guide/contact" },
       { text: "给我们 Star", link: "/zh/guide/star" },
-      { text: "分享获得积分", link: "/zh/guide/rewards" },
       { text: "更新日志", link: "https://github.com/nexu-io/nexu/releases" },
     ],
   },

docs/en/guide/model-pricing.md

@@ -0,0 +1,55 @@
+# Model Credit Consumption
+
+When using Nexu Official models, each conversation deducts credits based on the model type and token usage. This page lists the credit consumption for all currently available official models, helping you choose the right model and plan your credit usage.
+
+## Credit Consumption by Model
+
+Credits are charged separately for input tokens and output tokens, with different rates per model. The table below is sorted by estimated cost per conversation from lowest to highest.
+
+## How Many Credits Does a Conversation Cost?
+
+Using a typical single-turn conversation as an example — approximately 2,000 input tokens (including system prompt and context) and 2,000 output tokens:
+
+| Model | Rate | Est. Cost per Conversation | Conversations per 100 Credits |
+| --- | ---: | ---: | ---: |
+| deepseek-v3.2 | 0.18x | ≈ 0.13 credits | ≈ 769 |
+| minimax-m2.7 | 0.43x | ≈ 0.30 credits | ≈ 333 |
+| gemini-3.1-flash-lite-preview | 0.50x | ≈ 0.35 credits | ≈ 285 |
+| kimi-k2.5 | 0.60x | ≈ 0.42 credits | ≈ 238 |
+| glm-5 | 0.86x | ≈ 0.60 credits | ≈ 166 |
+| **gemini-3-flash-preview (default)** | **1.00x** | ≈ 0.70 credits | ≈ 142 |
+| mimo-v2-pro | 1.14x | ≈ 0.80 credits | ≈ 125 |
+| glm-5-turbo | 1.49x | ≈ 1.04 credits | ≈ 96 |
+| gpt-5.4-mini | 1.50x | ≈ 1.05 credits | ≈ 95 |
+
+> **Rate** indicates the cost ratio relative to the default model, gemini-3-flash-preview. For example, 0.50x means half the cost of the default model, while 1.50x means 1.5 times the cost.
+>
+> These are estimates sorted by cost from lowest to highest. Actual consumption depends on conversation length, context size, and model output. Complex tasks or multi-turn conversations will use significantly more tokens.
+
+## How to Choose the Right Model
+
+- **Maximum savings**: deepseek-v3.2 and minimax-m2.7 have the lowest cost per conversation, ideal for simple Q&A, casual chat, or when credits are limited.
+- **Balanced choice**: gemini-3.1-flash-lite-preview, kimi-k2.5, and glm-5 strike a good balance between capability and cost, suitable for most everyday tasks.
+- **Quality first**: gemini-3-flash-preview, mimo-v2-pro, glm-5-turbo, and gpt-5.4-mini offer stronger capabilities, better suited for coding assistance, deep analysis, and other demanding tasks.
+
+## How to Get More Credits
+
+nexu offers multiple ways to earn credits. See [Earn Points by Sharing](/guide/rewards) for details.
+
+## FAQ
+
+**Q: How are credits deducted?**
+
+Each conversation is billed based on the actual input tokens and output tokens consumed. The sum of both is the total credit cost for that conversation.
+
+**Q: What's the difference between input and output tokens?**
+
+Input tokens include your message, system prompts, and conversation context. Output tokens are the content generated by the model. Output tokens typically cost more because generating content requires more computation.
+
+**Q: Why do different models cost so much differently for the same conversation?**
+
+Different models have different capabilities and computational costs. More powerful models (e.g., gpt-5.4-mini, glm-5-turbo) cost more per conversation, while lightweight models (e.g., deepseek-v3.2, minimax-m2.7) are extremely affordable for simpler tasks.
+
+**Q: Does BYOK (Bring Your Own Key) mode consume credits?**
+
+No. In BYOK mode, you use your own API key to call model providers directly. Fees are charged by the provider, and no nexu credits are consumed.

docs/ja/guide/model-pricing.md

@@ -0,0 +1,55 @@
+# モデルのポイント消費について
+
+Nexu Official モデルを使用する場合、会話ごとにモデルの種類とトークン使用量に応じてポイントが差し引かれます。このページでは、現在利用可能なすべての公式モデルのポイント消費基準を掲載しています。モデルの選択やポイント利用の参考にしてください。
+
+## 各モデルのポイント消費一覧
+
+ポイントは入力トークンと出力トークンごとに別々に課金され、モデルによって単価が異なります。下表は1回の会話あたりの推定コストが低い順に並べています。
+
+## 1回の会話でどれくらいポイントを消費する？
+
+一般的な単一ターンの会話を例にします。入力約 2,000 トークン（システムプロンプトとコンテキストを含む）、出力約 2,000 トークンの場合：
+
+| モデル | 倍率 | 1回の会話の推定消費 | 100 ポイントで約何回会話できるか |
+| --- | ---: | ---: | ---: |
+| deepseek-v3.2 | 0.18x | ≈ 0.13 ポイント | ≈ 769 回 |
+| minimax-m2.7 | 0.43x | ≈ 0.30 ポイント | ≈ 333 回 |
+| gemini-3.1-flash-lite-preview | 0.50x | ≈ 0.35 ポイント | ≈ 285 回 |
+| kimi-k2.5 | 0.60x | ≈ 0.42 ポイント | ≈ 238 回 |
+| glm-5 | 0.86x | ≈ 0.60 ポイント | ≈ 166 回 |
+| **gemini-3-flash-preview（デフォルト）** | **1.00x** | ≈ 0.70 ポイント | ≈ 142 回 |
+| mimo-v2-pro | 1.14x | ≈ 0.80 ポイント | ≈ 125 回 |
+| glm-5-turbo | 1.49x | ≈ 1.04 ポイント | ≈ 96 回 |
+| gpt-5.4-mini | 1.50x | ≈ 1.05 ポイント | ≈ 95 回 |
+
+> **倍率**はデフォルトモデル gemini-3-flash-preview に対するコスト比率を表します。例えば 0.50x はデフォルトモデルの半額、1.50x は 1.5 倍のコストを意味します。
+>
+> 上記は推定値であり、コストの低い順に並べています。実際の消費は会話の長さ、コンテキストのサイズ、モデルの出力量によって異なります。複雑なタスクやマルチターンの会話では、トークン使用量が大幅に増加します。
+
+## モデルの選び方
+
+- **ポイント節約重視**：deepseek-v3.2 と minimax-m2.7 は1回の会話コストが非常に低く、簡単な質問、日常の雑談、またはポイントが限られている場合に最適です。
+- **バランス重視**：gemini-3.1-flash-lite-preview、kimi-k2.5、glm-5 は能力とコストのバランスが良く、ほとんどの日常的なシーンに適しています。
+- **品質重視**：gemini-3-flash-preview、mimo-v2-pro、glm-5-turbo、gpt-5.4-mini はより高い能力を持ち、コーディング支援や深い分析など、品質を重視するタスクに適しています。
+
+## ポイントの獲得方法
+
+nexu ではポイントを獲得するさまざまな方法を提供しています。詳しくは[シェアしてポイント獲得](/ja/guide/rewards)をご覧ください。
+
+## よくある質問
+
+**Q: ポイントはどのように差し引かれますか？**
+
+会話ごとに、実際に使用した入力トークンと出力トークンに基づいて課金されます。両者の合計がその会話のポイント消費となります。
+
+**Q: 入力トークンと出力トークンの違いは？**
+
+入力トークンには、送信したメッセージ、システムプロンプト、会話コンテキストが含まれます。出力トークンはモデルが生成した回答内容です。出力トークンは生成に多くの計算コストがかかるため、通常単価が高くなっています。
+
+**Q: 同じ会話なのに、モデルによって消費が大きく異なるのはなぜ？**
+
+モデルによって能力と計算コストが異なります。高性能なモデル（gpt-5.4-mini、glm-5-turbo など）は消費が高く、軽量モデル（deepseek-v3.2、minimax-m2.7 など）は非常に低コストで、シンプルなタスクに適しています。
+
+**Q: BYOK（自分のAPIキーを使用）モードではポイントが消費されますか？**
+
+いいえ。BYOK モードでは、ご自身の API キーでモデルプロバイダーに直接アクセスします。料金はプロバイダーから直接請求され、nexu のポイントは消費されません。

docs/zh/guide/model-pricing.md

@@ -0,0 +1,55 @@
+# 模型积分消耗说明
+
+使用 Nexu Official 模型时，每次对话会根据模型类型和 token 用量扣除相应积分。本文列出了当前所有官方模型的积分消耗标准，帮助你合理选择模型、规划积分使用。
+
+## 各模型积分消耗一览
+
+积分按实际消耗的输入 token 和输出 token 分别计费，不同模型的单价不同。下表按单次对话成本从低到高排列。
+
+## 一次对话大概花多少积分？
+
+以一次常见的单轮对话为例——输入约 2,000 token（含系统提示词和上下文），输出约 2,000 token：
+
+| 模型 | 倍率 | 单次对话约消耗 | 100 积分约可对话次数 |
+| --- | ---: | ---: | ---: |
+| deepseek-v3.2 | 0.18x | ≈ 0.13 积分 | ≈ 769 次 |
+| minimax-m2.7 | 0.43x | ≈ 0.30 积分 | ≈ 333 次 |
+| gemini-3.1-flash-lite-preview | 0.50x | ≈ 0.35 积分 | ≈ 285 次 |
+| kimi-k2.5 | 0.60x | ≈ 0.42 积分 | ≈ 238 次 |
+| glm-5 | 0.86x | ≈ 0.60 积分 | ≈ 166 次 |
+| **gemini-3-flash-preview（默认）** | **1.00x** | ≈ 0.70 积分 | ≈ 142 次 |
+| mimo-v2-pro | 1.14x | ≈ 0.80 积分 | ≈ 125 次 |
+| glm-5-turbo | 1.49x | ≈ 1.04 积分 | ≈ 96 次 |
+| gpt-5.4-mini | 1.50x | ≈ 1.05 积分 | ≈ 95 次 |
+
+> **倍率**表示该模型相对于默认模型 gemini-3-flash-preview 的费用比例。例如 0.50x 表示费用是默认模型的一半，1.50x 表示费用是默认模型的 1.5 倍。
+>
+> 以上为估算值，按单次对话消耗从低到高排列。实际消耗取决于对话长度、上下文大小和模型输出量，复杂任务或多轮对话的 token 用量会明显更高。
+
+## 如何选择合适的模型
+
+- **极致省积分**：deepseek-v3.2 和 minimax-m2.7 单次对话成本极低，适合简单问答、日常闲聊或积分有限时使用。
+- **均衡之选**：gemini-3.1-flash-lite-preview、kimi-k2.5、glm-5 在能力和成本之间取得了不错的平衡，适合大多数日常场景。
+- **能力优先**：gemini-3-flash-preview、mimo-v2-pro、glm-5-turbo、gpt-5.4-mini 能力更强，适合编程辅助、深度分析等对质量要求更高的任务。
+
+## 如何获取更多积分
+
+nexu 提供了多种获取积分的方式，详见 [分享赚积分](/zh/guide/rewards)。
+
+## 常见问题
+
+**Q: 积分是怎么扣的？**
+
+每次对话按实际使用的输入 token 和输出 token 分别计费，两者相加即为本次对话的积分消耗。
+
+**Q: 输入 token 和输出 token 有什么区别？**
+
+输入 token 包括你发送的消息、系统提示词和对话上下文；输出 token 是模型生成的回复内容。输出 token 单价通常更高，因为生成内容的计算成本更大。
+
+**Q: 为什么同样的对话，不同模型消耗差异很大？**
+
+不同模型的能力和计算成本不同。能力更强的模型（如 gpt-5.4-mini、glm-5-turbo）消耗相对更高；轻量模型（如 deepseek-v3.2、minimax-m2.7）成本极低，适合简单任务。
+
+**Q: BYOK（自带密钥）模式会扣积分吗？**
+
+不会。BYOK 模式使用你自己的 API Key 直接调用模型供应商的接口，费用由供应商直接收取，不消耗 nexu 积分。