diff --git a/English/.gitbook/assets/Package-plan/view-detail-package.png b/English/.gitbook/assets/Package-plan/view-detail-package.png new file mode 100644 index 00000000..36e669c3 Binary files /dev/null and b/English/.gitbook/assets/Package-plan/view-detail-package.png differ diff --git a/English/ai-stack/token-plan/a-z-guide.md b/English/ai-stack/token-plan/a-z-guide.md index b850bd84..33d3c2ba 100644 --- a/English/ai-stack/token-plan/a-z-guide.md +++ b/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 %} diff --git a/English/ai-stack/token-plan/buy-token-plan.md b/English/ai-stack/token-plan/buy-token-plan.md index d60c0815..d1237488 100644 --- a/English/ai-stack/token-plan/buy-token-plan.md +++ b/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)). diff --git a/Vietnamese/.gitbook/assets/Package-plan/view-detail-package.png b/Vietnamese/.gitbook/assets/Package-plan/view-detail-package.png new file mode 100644 index 00000000..36e669c3 Binary files /dev/null and b/Vietnamese/.gitbook/assets/Package-plan/view-detail-package.png differ diff --git a/Vietnamese/ai-stack/token-plan/huong-dan-a-z.md b/Vietnamese/ai-stack/token-plan/huong-dan-a-z.md index 54843bf3..7e744d1c 100644 --- a/Vietnamese/ai-stack/token-plan/huong-dan-a-z.md +++ b/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 %} diff --git a/Vietnamese/ai-stack/token-plan/mua-goi-token-plan.md b/Vietnamese/ai-stack/token-plan/mua-goi-token-plan.md index c7d04f85..b1015b65 100644 --- a/Vietnamese/ai-stack/token-plan/mua-goi-token-plan.md +++ b/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)).