Aiberm Skill

aiberm-skill dạy agent lập trình cách đọc tài khoản Aiberm của chính bạn. Sau khi cài, bạn có thể hỏi Claude Code, Codex, Grok Bot hoặc agent khác: “Số dư Aiberm của tôi còn bao nhiêu?” Agent sẽ gọi API của Aiberm và trả lời bằng ngôn ngữ dễ hiểu.

Skill này đọc số dư, mô hình, giá, API token, nhật ký sử dụng và lịch sử nạp tiền của bạn. Nó cũng có thể tạo, chỉnh sửa, kích hoạt, vô hiệu hóa và xóa API token của bạn, và luôn hỏi bạn trước mỗi thay đổi.

Điều kiện tiên quyết

• Một tài khoản Aiberm (Đăng ký tại đây)
• Một agent hỗ trợ Skill, chẳng hạn Claude Code, Codex hoặc Grok Bot
• git, curl và một shell tương thích bash. macOS và Linux thường có sẵn cả ba. Trên Windows, Claude Code dùng Git Bash.

1. Lấy ID người dùng và mã thông báo truy cập hệ thống

Skill cần hai giá trị, cả hai đều có trong Cài đặt cá nhân:

Aiberm kiểm tra cả hai giá trị ở mọi yêu cầu liên quan đến tài khoản, và ID phải thuộc về tài khoản sở hữu token.

2. Cài Skill

Dán prompt này vào Claude Code, Codex, Grok Bot hoặc agent khác, rồi để agent tự cài Skill:

Hãy cài Aiberm Skill từ https://github.com/aiberm/aiberm-skill: sao chép thư mục skills/aiberm của repository vào thư mục mà bạn tải Skill.

Khi agent cài xong, hãy bắt đầu một phiên mới. Để cập nhật Skill sau này, hãy gửi lại đúng prompt đó.

3. Đặt hai biến môi trường

Agent đọc các giá trị từ môi trường của nó, nên hãy đặt chúng trước khi khởi động agent.

macOS / Linux: thêm các dòng sau vào ~/.zshrc hoặc ~/.bashrc, rồi mở terminal mới:

export AIBERM_ACCESS_TOKEN="your-system-access-token"
export AIBERM_USER_ID="123"

Windows (PowerShell): chạy các lệnh bên dưới, rồi mở terminal mới:

setx AIBERM_ACCESS_TOKEN "your-system-access-token"
setx AIBERM_USER_ID "123"

Để kiểm tra các giá trị trước khi dùng agent, hãy gửi yêu cầu lấy hồ sơ của bạn. data.quota chia cho 500000 là số dư còn lại tính bằng USD.

curl -sS "https://aiberm.com/api/user/self" \
  -H "Authorization: Bearer $AIBERM_ACCESS_TOKEN" \
  -H "New-Api-User: $AIBERM_USER_ID"

4. Hỏi agent

Bắt đầu một phiên agent mới và hỏi theo cách của bạn:

• “Số dư Aiberm của tôi còn bao nhiêu?”
• “Hôm qua tôi tiêu bao nhiêu trên Aiberm, chia theo từng mô hình?”
• “Liệt kê các API token Aiberm của tôi và hạn mức còn lại của từng token.”
• “Trên Aiberm, claude-sonnet-5-5 giá bao nhiêu cho 1 triệu token?”
• “Tuần này tôi dùng mô hình nào nhiều nhất trên Aiberm?”
• “Cho tôi xem các lần nạp tiền gần đây trên Aiberm.”
• “Tạo một API key Aiberm tên my-app với hạn mức $5.”
• “Vô hiệu hóa token Aiberm old-test của tôi.”

Bạn cũng có thể gọi Skill trực tiếp: /aiberm trong Claude Code và Grok Bot, $aiberm trong Codex.

Số tiền được quy đổi sang USD theo tỷ lệ 500000 đơn vị hạn mức = $1. Giá là mức mà tài khoản của bạn thực sự phải trả.

Tạo và thay đổi API token

• Trước mỗi lần tạo, chỉnh sửa, kích hoạt, vô hiệu hóa hoặc xóa, agent cho bạn biết nó sẽ gửi gì và chờ bạn đồng ý.
• Trừ khi bạn yêu cầu khác, token mới có hạn mức không giới hạn và không hết hạn, giống như trong console. Bạn có thể yêu cầu hạn mức chi tiêu, ngày hết hạn hoặc danh sách mô hình được phép.
• Sau khi tạo token, agent hiển thị khóa đầy đủ của nó một lần. Hãy sao chép khóa vào ứng dụng hoặc cấu hình của bạn.
• Xóa token là không thể hoàn tác, và các ứng dụng dùng khóa của token đó sẽ ngừng hoạt động ngay lập tức.

Những việc skill không làm

• Ngoài API token, skill không thay đổi bất cứ thứ gì. Nó không thanh toán, không đổi mã nạp tiền và không chỉnh sửa tài khoản của bạn. Hãy dùng console cho những việc đó.
• Skill không đặt lại mã thông báo truy cập hệ thống của bạn. Skill yêu cầu agent không bao giờ gọi endpoint đó.
• Skill không để lộ khóa đầy đủ của các API token hiện có. Danh sách token chứa khóa đầy đủ, nhưng agent chỉ hiển thị dạng đã che, như sk-abcd****wxyz. Hãy sao chép khóa đầy đủ từ Quản lý mã thông báo. Ngoại lệ duy nhất là token mà agent vừa tạo cho bạn.

Xử lý sự cố

Mã nguồn của skill và danh sách đầy đủ các yêu cầu có trong repository aiberm-skill. Với lỗi từ chính API mô hình, xem Xử lý lỗi.