Tới nội dung
Đăng nhậpTạo tài khoản

Tài liệu APIVN

Bắt đầu 5 phút

Từ đăng ký tới request đầu tiên trong bốn bước.

Sơ đồ: tạo khoá trên APIVN, nhập vào CC Switch một chạm, rồi dùng trong Codex hoặc Claude Code

1. Đăng ký tài khoản

Mở apivn.vn/sign-up và đăng ký bằng email. Nếu có bước xác minh mà không thấy mã, hãy kiểm tra hộp thư Spam.

2. Nạp số dư

Tài khoản mới được tặng 3.000 ₫ để dùng thử khi đăng ký bằng Google, GitHub hoặc email Gmail, Outlook, Yahoo, iCloud, email trường .edu.vn, nên bạn chạy được ngay mà chưa cần nạp. Quà phát mỗi địa chỉ mạng và mỗi hộp thư một lần. Nếu tài khoản chưa nạp tiền, quà bị thu về khi không tiêu trong 24 giờ, hoặc khi tài khoản đăng nhập từ cùng địa chỉ mạng với một tài khoản khác đã nhận quà trong 30 ngày. Dùng chung mạng ở công ty, quán cà phê mà bị thu nhầm thì liên hệ để được trả lại.

Muốn dùng tiếp: Bảng điều khiển → Ví, chọn số tiền rồi quét mã VietQR bằng ứng dụng ngân hàng (đừng dùng MoMo, ShopeePay hay ZaloPay: chúng ghi đè nội dung chuyển khoản nên tiền không tự cộng được). Mỗi lần nạp là bội số của 26.000 ₫, từ 26.000 ₫ đến 49.998.000 ₫; số dư thường cộng trong khoảng một phút. Tiền bạn tự nạp không có hạn dùng. Chi tiết ở trang Nạp tiền.

3. Lấy khoá API

Cần thêm khoá để tách chi phí từng dự án thì bấm Tạo Khóa API. Dùng CC Switch thì khoá được nhập tự động; cấu hình tay thì chép khoá dạng sk-.... Xem thêm Khoá API & hạn mức.

Trang Khóa API: mỗi khoá hiện nhóm Tự động, nút Tạo Khóa API ở góc phải
Bảng điều khiển → Khóa API → Tạo Khóa API.
Bảng Tạo Khóa API trượt ra từ bên phải: ô Nhóm đã sẵn Tự động, kèm thứ tự nhóm Auto
Chỉ cần đặt tên rồi Lưu thay đổi. Ô Nhóm cứ để nguyên Tự động.

4. Chọn cách dùng

Bảng dưới xếp theo việc bạn muốn làm. Khoá sẵn có của bạn ở nhóm Tự động dùng được tất cả những cách này.

Bạn muốnDùng gìCần terminal
Hỏi đáp, soạn thảo, dịch, đọc tài liệuCherry StudioKhông
Viết code với GPTỨng dụng ChatGPT (Codex) + CC SwitchKhông
Viết code với ClaudeClaude Code + CC SwitchCó
Tạo ảnh với GPT Image 2 hoặc 2.5Gọi APICó
Nhúng AI vào sản phẩm riêngSDK OpenAI, cURLViết code

Tự cấu hình một ứng dụng bất kỳ: địa chỉ kiểu OpenAI https://apivn.vn/v1, kiểu Anthropic (Claude Code) https://apivn.vn.

Kiểm tra bằng cURL

Với khoá sẵn có của bạn:

curl https://apivn.vn/v1/chat/completions \
  -H "Authorization: Bearer $APIVN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{"role": "user", "content": "Xin chào APIVN"}]
  }'

Nhận về JSON có câu trả lời nghĩa là kết nối đã thông. Đổi claude-sonnet-5 sang bất kỳ mô hình nào trong Mô hình đều chạy, vẫn dùng đúng khoá đó.

Hỏi hỗ trợ