Tạo API key
Bước đầu tiên — tạo key, kiểm tra số dư, quota và chọn đúng group trước khi cài công cụ
Làm bước này trước khi cài Codex, Claude hoặc bất kỳ client tool nào. Bạn cần API key của hệ thống và phải đáp ứng cả ba điều kiện sau:
| Điều kiện | Kiểm tra ở đâu? | Cần đảm bảo |
|---|---|---|
| Số dư tài khoản | https://api.vnaipro.app/wallet | Số dư đủ để thanh toán request bạn muốn chạy |
| Quota của API key | https://api.vnaipro.app/keys | Key còn đủ hạn mức sử dụng; số dư tài khoản còn không có nghĩa quota của key còn |
| Đúng group | https://api.vnaipro.app/keys | Group của key đúng với model/công cụ sẽ sử dụng |
1. Đăng nhập và kiểm tra số dư
- Mở trang ví: https://api.vnaipro.app/wallet.
- Đăng nhập tài khoản của bạn nếu chưa đăng nhập.
- Kiểm tra số dư và nạp thêm theo hướng dẫn trên website nếu chưa đủ.
Số dư tài khoản và quota của API key là hai giới hạn riêng. Nạp thêm tiền vào ví không đồng nghĩa với việc tăng quota đã đặt cho một key.
2. Tạo API key
- Mở trang quản lý key: https://api.vnaipro.app/keys.
- Chọn chức năng tạo API key mới.
- Đặt tên dễ nhận biết, ví dụ
auto-laptop. - Chọn group Auto để dùng chung một key cho Codex, Claude và các model khác, hoặc chọn group riêng theo bảng bên dưới.
- Đặt quota/hạn mức đủ cho nhu cầu sử dụng. Nếu key có giới hạn model, cho phép model bạn định dùng.
- Tạo/lưu key, rồi sao chép giá trị API key để cấu hình công cụ.
Giữ key riêng tư. Dán nguyên key vào ô API key của client, không thêm tiền tố Bearer .
3. Chọn đúng group
| Bạn muốn dùng | Group cần chọn |
|---|---|
| Dùng chung một key cho Codex, Claude và các model khác | Group Auto (khuyến nghị), với các model được hỗ trợ trong group |
| Codex — CLI, extension hoặc app | Group Auto hoặc group Codex có model dùng cho Codex |
| Claude Code / Claude app | Group Auto hoặc group Claude có model Claude |
| OpenClaw, Hermes, OpenCode, Cursor, Qwen Code, Chatbox, Cline, DeepSeek Harness | Group Auto hoặc group riêng có model bạn chọn; client phải hỗ trợ giao thức của model |
Group Auto: một key cho nhiều công cụ
Với group Auto, dùng cùng một API key cho Codex, Claude Code, Claude app và các client khác với model được hỗ trợ. Không cần tạo key riêng cho từng công cụ. Các group riêng như Codex hoặc Claude vẫn giới hạn theo model được cấp trong group.
Với client hỗ trợ nhiều model như OpenCode, bạn có thể dùng cùng key group Auto cho cả model Codex và Claude, nhưng vẫn cần chọn adapter/giao thức tương ứng với từng model. Kiểm tra danh sách model của group và giới hạn model của key trước khi cấu hình.
4. Kiểm tra key trước khi cài công cụ
- Mở Kiểm tra model, nhập key vừa tạo.
- Sao chép model ID chính xác từ kết quả để dùng trong cấu hình client.
- Xác nhận lại số dư đủ + quota key đủ + đúng group.
- Chọn hướng dẫn cài đặt bên dưới.
Lấy được danh sách model chưa đảm bảo request có thể chạy nếu tài khoản thiếu số dư hoặc key hết quota. Nếu vẫn lỗi, kiểm tra thông báo lỗi và quay lại https://api.vnaipro.app/wallet cùng https://api.vnaipro.app/keys.