Quản lý API key RocketKey: tạo, đổi tên, khoá, tạo lại và xoá key

Mọi thao tác với key nằm ở Dashboard → API keys. Bạn có thể tạo nhiều key (mỗi máy hoặc mỗi công cụ một key), đổi tên, khoá tạm, tạo lại và xoá key bất cứ lúc nào. Mọi key của tài khoản dùng chung một hạn mức USD mỗi ngày và chung giới hạn request mỗi phút của gói: tạo thêm key không làm tăng hạn mức.

Nếu bạn chưa có gói, đọc Bắt đầu trước.

Mỗi gói được bao nhiêu key?

Gói	Số key tối đa	Request mỗi phút
Mini	1	30
Starter	2	60
Pro	3	120
Max	5	240

Số liệu lấy từ Bảng giá. Trang API keys hiện số key đang dùng trên số tối đa, ví dụ 2/3 key. Khi đã đủ, hãy xoá một key không dùng nữa để tạo key mới.

Tạo key mới

1. Vào Dashboard → API keys, bấm Tạo key.
2. Đặt tên để nhận ra máy hoặc công cụ dùng key, ví dụ MacBook, máy công ty, CI. Tên dài 1–40 ký tự và không trùng tên key khác.
3. Bấm Tạo key. Key hiện ra một lần duy nhất: sao chép ngay, rồi bấm Tôi đã lưu key.

RocketKey chỉ lưu mã băm của key cùng vài ký tự đầu và 4 ký tự cuối để bạn nhận ra key trong danh sách. Vì vậy không ai, kể cả bộ phận hỗ trợ, xem lại được key đầy đủ. Mất key thì dùng Tạo lại (bên dưới).

Nếu gói vừa được kích hoạt, key mới có thể ở trạng thái Đang kích hoạt… trong ít phút. Trang tự cập nhật, bạn không cần làm gì thêm.

Dùng key ở đâu

Cùng một key dùng được cho mọi công cụ, chỉ khác cách khai báo:

• Claude Code: biến ANTHROPIC_BASE_URL và ANTHROPIC_AUTH_TOKEN. Xem hướng dẫn Claude Code.
• Codex CLI: file config.toml và biến ROCKETKEY_API_KEY. Xem hướng dẫn Codex.
• Cline và Cursor: ô Base URL và API Key trong phần cài đặt. Xem Cline, Cursor.
• Code của bạn (Python, Node.js): xem Gọi API bằng Python và Node.js.

Kiểm tra key mới bằng lệnh curl miễn phí ở bước 3 của Bắt đầu.

Đọc danh sách key

Mỗi dòng trong bảng có:

• Tên và Key: tên bạn đặt, và key đã che, chỉ hiện phần đầu và 4 ký tự cuối.
• Ngày tạo và Dùng lần cuối: key nào lâu không dùng là ứng viên để xoá.
• Hôm nay và 30 ngày: số USD key đó đã tiêu, giúp bạn biết máy nào tốn hạn mức nhất.
• Trạng thái: Hoạt động, Bạn đã khoá, Gói hết hạn — key tạm khoá, hoặc Đang áp dụng… khi một thay đổi đang được đồng bộ.

Đổi tên, khoá, tạo lại, xoá

Mở menu Thao tác ở cuối dòng của key:

Thao tác	Tác dụng	Khi nào dùng
Đổi tên	Chỉ đổi tên hiển thị, key giữ nguyên.	Đổi máy, đổi mục đích dùng.
Khoá	Mọi request dùng key bị từ chối cho tới khi mở khoá. Có thể mất tới một phút để có hiệu lực.	Tạm ngừng một máy mà không phải cài lại key.
Mở khoá	Key hoạt động lại sau vài giây nếu gói còn hạn.	Dùng lại key đã khoá.
Tạo lại	Key cũ ngừng hoạt động ngay, bạn nhận key mới (hiện một lần) với cùng tên.	Mất key, hoặc nghi key bị lộ.
Xoá	Key ngừng hoạt động ngay và không khôi phục được. Lịch sử usage của key vẫn được giữ.	Bỏ hẳn một máy hoặc công cụ.

Sau khi Tạo lại, hãy cập nhật key mới vào mọi máy đang dùng key cũ, nếu không các máy đó sẽ gặp lỗi 401.

Theo dõi usage theo từng key

Trang Dashboard → Usage cho thấy chi phí, số request và token theo ngày giờ Việt Nam (GMT+7), cập nhật mỗi 2 phút:

• Mục Phân bổ có hai chế độ Theo model và Theo key, để biết model nào và máy nào tiêu nhiều nhất.
• Nhật ký request liệt kê từng request: thời điểm, model, token, chi phí và lỗi rút gọn. RocketKey không lưu nội dung prompt.
• Xuất CSV tải dữ liệu của khoảng ngày đang chọn.

Khi tổng chi phí trong ngày chạm hạn mức, mọi key nhận lỗi 402 tới 00:00 (GMT+7). Gửi quá nhiều request một lúc sẽ gặp lỗi 429. Muốn dùng hạn mức hiệu quả hơn, xem Tiết kiệm hạn mức khi dùng Claude Code.

Giữ key an toàn

• Mỗi máy, mỗi công cụ một key: khi một máy bị mất hay bị lộ key, chỉ cần khoá hoặc tạo lại key của máy đó.
• Không dán key vào code, ảnh chụp màn hình, issue hay kho mã công khai. Đặt key trong biến môi trường hoặc file cấu hình nằm ngoài repo.
• Thấy usage lạ ở một key trong mục Theo key: bấm Tạo lại ngay cho key đó.

Khi gói hết hạn

Key không bị xoá. Chúng chuyển sang trạng thái Gói hết hạn — key tạm khoá và hoạt động lại ngay khi bạn gia hạn, không cần cài lại key. Xem gói hiện tại ở Dashboard → Gói & thanh toán.