Bắt đầu với APIVN trong 5 phút

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ư

Vào 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; số dư thường được cộng trong khoảng một phút. Tiền bạn nạp không có hạn dùng. Chi tiết ở trang Nạp tiền.

Chat thử trên web trước

Chưa muốn cài gì? Đăng nhập Bảng điều khiển, mở thanh bên và chọn Trò chuyện → Chat với AI. Bấm tên mô hình ở góc dưới ô chat, chọn nhóm (Claude, GPT, Gemini, Grok, DeepSeek, China) rồi chọn mô hình và gõ câu hỏi. Không cần khoá; tiền trừ vào số dư giống như gọi API. Trang này chỉ chat văn bản, tạo ảnh vẫn phải gọi API.

Trang Chat với AI: bấm tên mô hình để chọn nhóm và mô hình rồi chat — **Trò chuyện → Chat với AI**: bấm tên mô hình ở góc dưới, chọn nhóm bên trái rồi mô hình bên phải.

3. Tạo khoá API và chọn nhóm

Bảng điều khiển → Khóa API → Tạo Khóa API. Chọn nhóm theo mô hình định dùng: GPT (OpenAI), Claude (Anthropic), Grok (xAI), Gemini (Google), DeepSeek hoặc China (Kimi, GLM). 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 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 API** → **Tạ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**.

4. Chọn cách dùng

Bảng dưới xếp theo việc bạn muốn làm. Khoá phải thuộc đúng nhóm của mô hình.

Bạn muốn	Dùng gì	Nhóm khoá	Cần terminal
Chat thử ngay, chưa cài gì	Bảng điều khiển → Chat với AI	Không cần khoá	Không
Hỏi đáp, soạn thảo, dịch, đọc tài liệu	Cherry Studio	Theo mô hình bạn chọn	Không
Viết code với GPT	Ứng dụng ChatGPT (Codex) + CC Switch	GPT	Không
Viết code với Claude	Claude Code + CC Switch	Claude	Có
Tạo ảnh với GPT Image 2 hoặc 2.5	Gọi API	GPT	Có
Nhúng AI vào sản phẩm riêng	SDK OpenAI, cURL	Theo mô hình	Viế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á nhóm Claude:

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"}]
  }'

Mô hình phải thuộc nhóm của khoá. Nhận về JSON có câu trả lời nghĩa là kết nối đã thông.