[docs] AI Stack — Token Plan: add screenshots to the A-Z guide — VI + EN

English/ai-stack/token-plan/a-z-guide.md

@@ -54,15 +54,19 @@ Not enough credit? Top up in the AI Platform Console before buying — the syste
    *Example, the **Token Plan Alpha** card: `1,080,000 VND / 30 days` — GLM 5.2 model — up to 5 keys.*
 2. Click a card to open **Package Detail** and read it carefully before spending:
 
+![The Packages list — one card per Plan Type](../../.gitbook/assets/Package-plan/packages-list.png)
+
 | Look at | To learn |
 |---|---|
 | **Max keys** | How many people/tools you can issue keys to |
 | **Duration** | The plan cycle (usually 30 days) |
 | **Tokens / Requests per cycle** | The allowance per cycle — tracked **independently per model**, with no transfer between them |
-| **Included Models** | The models you can call (Model, Status, **Model code**, Provider) — remember the **Model code**, you'll need to enter it in your tool shortly |
+| **Included Models** | The plan's model table (Model, Hosting mode, Status, Token quota, Request quota). **Click the model name** to see its **Model code** — note it down, you'll need to enter it in your tool shortly |
 | **Subscription Endpoint** | `https://tokenplan.api.greennode.ai` — this is the **Base URL** you will use. OpenAI-standard tools append `/v1`, Anthropic-standard tools do **not** — see [Section 5](#5-set-it-up-in-the-tool-running-your-agent) |
 | **What happens when activated** | What happens right after activation |
 
+![Package Detail — max keys, duration, included models and the Subscription Endpoint](../../.gitbook/assets/Package-plan/view-detail-package.png)
+
 {% hint style="warning" %}
 Once purchased, a plan **cannot be swapped for a different Plan Type** and **cannot be returned on request**. If you must stop mid-cycle, use **Delete** — the unused allowance is refunded pro rata to Credits. Think it through at this step.
 {% endhint %}
@@ -111,10 +115,14 @@ The **Plan Detail** page has 2 tabs — you need information from both:
   - **Anthropic**-standard tools (Claude Code, Claude Desktop): `https://tokenplan.api.greennode.ai` — **no** `/v1`
 - The **Model code** of the model you want (e.g. `glm-5.2`) — copy it exactly, one wrong character breaks the call
 
+![Plan Detail — Models tab: the gateway base URL and each model's code](../../.gitbook/assets/Package-plan/detail-tab-models.png)
+
 **The `Subscription keys` tab** → grab the key:
 
 - Copy `default-key` (or a key you created yourself in [Section 6](#6-manage-issue-a-key-to-each-member))
 
+![Plan Detail — Subscription keys tab](../../.gitbook/assets/Package-plan/detail-tab-keys.png)
+
 Jot these 3 values down:
 
 | Information | Value |
@@ -266,6 +274,8 @@ This section is for whoever holds **Root/Admin** and needs to share a plan acros
 
 The list shows: plan name, Plan Type, expiry date (**Expires**), and **Auto-renew** status.
 
+![The My Token Plans list](../../.gitbook/assets/Package-plan/my-token-plan-list.png)
+
 | Status | Meaning |
 |---|---|
 | `ACTIVE` | The plan is running |
@@ -304,6 +314,8 @@ Name them `{department}-{name}` or `{system}-{environment}` — the name alone s
 3. The popup shows what the key inherits from the plan: access to **every model in the plan**, the plan's **shared** token/request allowance, and **the same gateway endpoint**
 4. Click **Create key**
 
+![Create subscription key popup](../../.gitbook/assets/Package-plan/Create-subscription-key.png)
+
 The new key appears with status `ACTIVE` and automatically shows up on the [Access Control](../agent-base/access-control/README.md) page with `Key Type = Plan: {plan name}` — the same record, no duplicate.
 
 **Step 3 — Hand the key to the member.** Send each person exactly 3 values:
@@ -343,6 +355,8 @@ Click the **Auto-renew** toggle in the list or in Plan Detail. The **Turn off au
 - No credit is charged now, and **no refund** is issued for turning Auto-renew off
 - You can turn it back on, or **Buy again**, anytime before the plan expires
 
+![Turn off auto-renew popup](../../.gitbook/assets/Package-plan/turn-off-auto-renew.png)
+
 {% hint style="info" %}
 With Auto-renew ON, the system renews before expiry. If credit is short, it retries — and if that still fails, the plan becomes `EXPIRED` and the whole team loses model access. **Keep enough credit on hand before the expiry date.**
 {% endhint %}
@@ -351,6 +365,8 @@ With Auto-renew ON, the system renews before expiry. If credit is short, it retr
 
 In **Plan Detail** click **Delete**, or in **My Token Plans** tick the checkbox and click the trash icon (bulk). The popup spells it out: every key is torn down **immediately**, the unused allowance is refunded **pro rata** to Credits, and the plan disappears from the list while usage history is retained for auditing.
 
+![Delete Token Plan popup](../../.gitbook/assets/Package-plan/delete-plan-alert.png)
+
 {% hint style="warning" %}
 Deleting a plan **cannot be undone**. Tell the team before you click.
 {% endhint %}

English/ai-stack/token-plan/buy-token-plan.md

@@ -23,7 +23,7 @@
 **Step 2: View details before buying**
 
 1. Click a Plan Type to open **Package Detail**
-2. Review Max keys, Model count, Duration, the token/request allowance per cycle, the **Included Models** table (Model, Status, Model code, Provider), **What happens when activated**, and the **Subscription Endpoint** — host `tokenplan.api.greennode.ai`, with `/v1` for OpenAI-standard tools and **no** `/v1` for Anthropic-standard tools
+2. Review Max keys, Model count, Duration, the token/request allowance per cycle, the **Included Models** table (Model, Hosting mode, Status, Token quota, Request quota — **click a model name** to see its Model code), **What happens when activated**, and the **Subscription Endpoint** — host `tokenplan.api.greennode.ai`, with `/v1` for OpenAI-standard tools and **no** `/v1` for Anthropic-standard tools
 
 {% hint style="warning" %}
 Once purchased, a plan **cannot be swapped for a different Plan Type or returned on request**. To stop a plan mid-cycle, use **Delete** instead — the unused allowance for the current cycle is refunded pro rata to Credits (see [Manage Token Plan](manage-token-plan.md)).

Vietnamese/ai-stack/token-plan/huong-dan-a-z.md

@@ -54,15 +54,19 @@ Credit chưa đủ? Nạp thêm tại AI Platform Console trước khi mua — h
    *Ví dụ card **Token Plan Alpha**: `1.080.000 VND / 30 ngày` — model GLM 5.2 — tối đa 5 keys.*
 2. Bấm vào 1 card để mở **Package Detail** và đọc kỹ trước khi xuống tiền:
 
+![Danh sách Packages — mỗi Plan Type là một card](../../.gitbook/assets/Package-plan/packages-list.png)
+
 | Xem mục                              | Để biết                                                                                                                                 |
 | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
 | **Max keys**                    | Cấp được tối đa bao nhiêu người/tool                                                                                              |
 | **Duration**                    | Chu kỳ gói (thường 30 ngày)                                                                                                           |
 | **Tokens / Requests per cycle** | Hạn mức mỗi chu kỳ — tính **riêng cho từng model**, không bù trừ qua lại                                                  |
-| **Included Models**             | Danh sách model được gọi (Model, Status, **Model code**, Provider) — nhớ **Model code**, lát nữa cần điền vào tool |
+| **Included Models** | Bảng model trong gói (Model, Hosting mode, Status, Token quota, Request quota). **Nhấp vào tên model** để xem **Model code** — nhớ lấy, lát nữa cần điền vào tool |
 | **Subscription Endpoint** | `https://tokenplan.api.greennode.ai` — chính là **Base URL** bạn sẽ dùng. Tool chuẩn OpenAI thêm `/v1` ở cuối, tool chuẩn Anthropic thì **không** — xem [Mục 5](#5-setup-vao-tool-dang-chay-agent) |
 | **What happens when activated** | Điều gì xảy ra ngay sau khi kích hoạt                                                                                                |
 
+![Package Detail — Max keys, Duration, Included Models và Subscription Endpoint](../../.gitbook/assets/Package-plan/view-detail-package.png)
+
 {% hint style="warning" %}
 Gói đã mua **không đổi được sang Plan Type khác** và **không trả lại tuỳ ý**. Nếu buộc phải dừng giữa chu kỳ, dùng **Delete** — phần hạn mức chưa dùng được hoàn pro rata vào Credits. Cân nhắc kỹ ở bước này.
 {% endhint %}
@@ -111,10 +115,14 @@ Trang **Plan Detail** có 2 tab — bạn cần lấy thông tin ở cả hai:
   - Tool chuẩn **Anthropic** (Claude Code, Claude Desktop): `https://tokenplan.api.greennode.ai` — **không** có `/v1`
 - **Model code** của model muốn dùng (ví dụ `glm-5.2`) — copy chính xác, sai một ký tự là lỗi
 
+![Plan Detail — tab Models: Gateway base URL và Model code từng model](../../.gitbook/assets/Package-plan/detail-tab-models.png)
+
 **Tab `Subscription keys`** → lấy chìa khoá:
 
 - Copy `default-key` (hoặc key bạn tự tạo ở [Mục 6](#6-quan-ly-cap-phat-cho-tung-thanh-vien))
 
+![Plan Detail — tab Subscription keys](../../.gitbook/assets/Package-plan/detail-tab-keys.png)
+
 Chép 3 giá trị này ra Notepad:
 
 | Thông tin         | Giá trị                                      |
@@ -266,6 +274,8 @@ Phần này dành cho người nắm **Root/Admin** cần chia gói cho cả nh
 
 Danh sách hiển thị: tên plan, Plan Type, ngày hết hạn (**Expires**), trạng thái **Auto-renew**.
 
+![Danh sách My Token Plans](../../.gitbook/assets/Package-plan/my-token-plan-list.png)
+
 | Trạng thái | Ý nghĩa                                                                  |
 | ------------ | -------------------------------------------------------------------------- |
 | `ACTIVE`   | Gói đang chạy                                                           |
@@ -304,6 +314,8 @@ Mua nhiều gói song song = nhiều plan instance **độc lập**, quota **kh
 3. Popup cho biết key sẽ kế thừa từ gói: gọi được **toàn bộ model trong gói**, **dùng chung** hạn mức token/request, **cùng 1 gateway endpoint**
 4. Bấm **Create key**
 
+![Popup Create subscription key](../../.gitbook/assets/Package-plan/Create-subscription-key.png)
+
 Key mới xuất hiện với trạng thái `ACTIVE`, đồng thời tự động hiện trên trang [Access Control](../agent-base/access-control/README.md) với nhãn `Key Type = Plan: {tên gói}` — cùng một bản ghi, không bị trùng.
 
 **Bước 3 — Giao key cho thành viên.** Gửi cho mỗi người đúng 3 giá trị:
@@ -343,6 +355,8 @@ Bấm toggle **Auto-renew** trong danh sách hoặc trong Plan Detail. Popup **T
 - Không trừ credit lúc này, và **không hoàn tiền** cho việc tắt Auto-renew
 - Bật lại, hoặc **Buy again**, bất cứ lúc nào trước khi gói hết hạn
 
+![Popup Turn off auto-renew](../../.gitbook/assets/Package-plan/turn-off-auto-renew.png)
+
 {% hint style="info" %}
 Auto-renew ON: hệ thống gia hạn trước hạn. Nếu credit không đủ, hệ thống retry — vẫn thất bại thì gói chuyển `EXPIRED` và cả nhóm mất quyền gọi model. **Nhớ giữ đủ credit trước ngày hết hạn.**
 {% endhint %}
@@ -351,6 +365,8 @@ Auto-renew ON: hệ thống gia hạn trước hạn. Nếu credit không đủ,
 
 Trong **Plan Detail** bấm **Delete**, hoặc trong **My Token Plans** tick checkbox rồi bấm icon thùng rác (bulk). Popup nêu rõ: toàn bộ key bị vô hiệu **ngay lập tức**, hạn mức chưa dùng được hoàn **pro rata** vào Credits, gói biến mất khỏi danh sách nhưng lịch sử usage vẫn giữ để đối soát.
 
+![Popup Delete Token Plan](../../.gitbook/assets/Package-plan/delete-plan-alert.png)
+
 {% hint style="warning" %}
 Xoá gói **không thể hoàn tác**. Báo trước cho cả nhóm trước khi bấm.
 {% endhint %}

Vietnamese/ai-stack/token-plan/mua-goi-token-plan.md

@@ -23,7 +23,7 @@
 **Bước 2: Xem chi tiết trước khi mua**
 
 1. Nhấn vào 1 Plan Type để mở **Package Detail**
-2. Xem đầy đủ: số Max keys, số Model, Duration, hạn mức token/request mỗi chu kỳ, danh sách **Included Models** (Model, Status, Model code, Provider), mục **What happens when activated**, và **Subscription Endpoint** — host `tokenplan.api.greennode.ai`, thêm `/v1` cho tool chuẩn OpenAI và **không** có `/v1` cho tool chuẩn Anthropic
+2. Xem đầy đủ: số Max keys, số Model, Duration, hạn mức token/request mỗi chu kỳ, bảng **Included Models** (Model, Hosting mode, Status, Token quota, Request quota — **nhấp vào tên model** để xem Model code), mục **What happens when activated**, và **Subscription Endpoint** — host `tokenplan.api.greennode.ai`, thêm `/v1` cho tool chuẩn OpenAI và **không** có `/v1` cho tool chuẩn Anthropic
 
 {% hint style="warning" %}
 Gói đã mua **không thể đổi sang Plan Type khác hoặc trả lại theo yêu cầu tùy ý**. Nếu cần dừng gói giữa chu kỳ, dùng action **Delete** — phần hạn mức chưa dùng của chu kỳ hiện tại sẽ được hoàn lại pro rata vào Credits (xem [Quản lý Token Plan](quan-ly-token-plan.md)).