Tới nội dung

Tài liệu APIVN

Khoá API: nhóm và hạn mức

Mỗi khoá thuộc đúng một nhóm, chỉ gọi được mô hình trong nhóm đó, và có thể đặt hạn mức riêng.

Tạo khoá

  1. Đăng nhập Bảng điều khiển.
  2. Vào Khóa API → Tạo Khóa API.
  3. Đặt tên theo dự án hoặc theo máy sẽ dùng khoá.
  4. Chọn nhóm theo bảng bên dưới.
  5. Tuỳ chọn: ngày hết hạn, hạn mức tiền, giới hạn mô hình và IP (xem phần dưới).
Trang Khóa API trong bảng điều khiển APIVN, nút Tạo Khóa API ở góc phải
Bảng điều khiển → Khóa APITạo Khóa API.
Hộp Tạo Khóa API: nhập tên, mở danh sách Nhóm và chọn Claude, rồi Lưu thay đổi
Đặt tên, mở ô Nhóm chọn nhóm (ví dụ Claude), rồi Lưu thay đổi.

Nhóm nào cho việc gì

NhómHợp vớiModel
GPTCodex, SDK OpenAI, ứng dụng chatgpt-5.6-sol, gpt-5.6, gpt-6-astra, gpt-5.5, codex-auto-review, gpt-5.6-terra, gpt-image-2, gpt-image-2.5
ClaudeClaude Code, ứng dụng chatclaude-sonnet-5, claude-opus-5, claude-opus-4-8, claude-sonnet-4-6, claude-fable-5, claude-opus-4-7, claude-opus-4-6, claude-haiku-4-5, claude-fable-5-1
GrokỨng dụng chat, việc số lượng lớngrok-4.6, grok-4.5
GeminiỨng dụng chat, front-end, việc số lượng lớngemini-3.1-pro-preview, gemini-3.8-flash, gemini-3.7-flash
DeepSeekTrò chuyện và lập trình giá mềm qua SDK OpenAIdeepseek-v4-pro, deepseek-v4-flash, deepseek-v4.1-flash
ChinaKimi và GLM qua SDK OpenAIkimi-k3, glm-5.3, glm-5.3-flash

Cần mô hình ở nhiều nhóm thì tạo mỗi nhóm một khoá. CC Switch nhận khoá nhóm GPT (cho Codex trong ứng dụng ChatGPT) hoặc Claude (cho Claude Code); các nhóm còn lại dùng qua Cherry Studio hoặc gọi API.

Giữ khoá an toàn

Đừng đặt khoá trong mã chạy trên trình duyệt, trong URL, trong Git hay ảnh chụp màn hình. Nghi ngờ lộ khoá thì vô hiệu hoá ngay và tạo khoá mới. Nên đặt hạn mức cho từng khoá.

Hạn mức và giới hạn

Khi tạo hoặc sửa khoá trong Bảng điều khiển → Khóa API, bạn đặt được:

  • Hạn mức: số tiền tối đa khoá được tiêu.
  • Thời hạn: ngày khoá hết hiệu lực.
  • Giới hạn mô hình: chỉ cho phép một số mô hình nhất định.
  • Giới hạn IP: chỉ nhận request từ địa chỉ IP bạn chỉ định.

Dùng khi:

  • Phát khoá cho từng thành viên, mỗi người một hạn mức.
  • Gắn khoá vào script chạy tự động, tránh một vòng lặp lỗi tiêu sạch số dư.
  • Bán lại dịch vụ cho khách của bạn với hạn mức riêng cho mỗi khách.

Khoá hết hạn mức thì sao

Chỉ khoá đó ngừng hoạt động; số dư tài khoản và các khoá khác không bị ảnh hưởng. Nâng hạn mức hoặc tạo khoá mới để dùng tiếp.