Hướng dẫn sử dụng

Hai luồng sử dụng: mua gói hoặc dùng voucher

Hướng dẫn A-Z

2 luồng dùng NttCodex: mua gói hoặc dùng voucher

Dùng tài khoản xong thì rẽ theo 1 trong 2 đường. Luồng 1 là nạp tiền rồi mua gói. Luồng 2 là nhập voucher để nhận tiền hoặc nhận gói, rồi bỏ qua bước mua nếu voucher đã cấp sẵn gói.

Tạo tài khoản
Nạp tiền hoặc voucher
Mua gói nếu cần
Gọi API

1. Đăng ký hoặc đăng nhập

  1. Vào trang chủ.
  2. Nếu chưa có tài khoản, đăng ký ngay trên màn hình đầu.
  3. Đăng nhập để mở khu người dùng.
  4. Vào xong sẽ thấy số dư, key, quota còn lại và lịch sử request gần nhất.

Nguyên tắc

Sau khi vào hệ thống, mọi thứ xoay quanh số dư, gói đã mua, voucher và API key. Không cần chạm admin nếu chỉ dùng bình thường.

2. Luồng mua gói

Bước 1Nạp tiền
Bước 2Vào Mua gói
Bước 3Chọn gói và mua
  1. Vào Nạp tiền và tạo yêu cầu nạp nếu số dư chưa đủ.
  2. Chờ admin duyệt nạp. Khi duyệt xong, số dư tăng.
  3. Vào Mua gói, chọn gói còn mở bán và mua.
  4. Sau khi mua, gói nằm trong lịch sử gói đã mua và có thể dùng để tạo key.

3. Luồng voucher

  1. Vào Voucher.
  2. Nhập mã voucher được cấp.
  3. Nếu voucher cộng tiền thì số dư tăng, rồi bạn mua gói như luồng 1.
  4. Nếu voucher tặng gói trực tiếp thì bỏ qua bước mua, chuyển sang tạo key ngay.

Kết luận voucher

Voucher có 2 kiểu tác động: cộng số dư hoặc cấp gói. Chỉ khi voucher chưa cấp gói thì mới cần quay lại bước mua gói.

4. Tạo API key

  1. Vào API key.
  2. Nhập tên key dễ nhớ.
  3. Chọn gói còn quota trống.
  4. Đặt quota ngày cho key.
  5. Bấm tạo key rồi copy key để dùng ở client.

Khi nào tạo key

Chỉ cần tạo key sau khi đã có gói hợp lệ. Gói có thể đến từ mua gói hoặc từ voucher tặng gói.

5. Cài qua Codex CLI

Truy cập API key và bấm Cách dùng trên key cần dùng.

6. Gọi API trực tiếp qua proxy

Request đi qua path /v1 và dùng API key trong header Authorization. Cách này dùng cho curl, app riêng, backend hoặc frontend cần gọi API trực tiếp.

Curl

curl https://your-domain.example/v1/chat/completions \
  -H "Authorization: Bearer YOUR_NTTCODEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_NAME",
    "messages": [{"role":"user","content":"Xin chào"}],
    "max_tokens": 300
  }'

JavaScript fetch

const res = await fetch("https://your-domain.example/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_NTTCODEX_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "MODEL_NAME",
    messages: [{ role: "user", content: "Xin chào" }],
    max_tokens: 300
  })
});

7. Xem usage

Vào Lịch sử để xem request, model, input token, output token, tổng token và thời lượng.

8. Theo dõi quota

Trang Tổng quan và API key cho biết quota còn lại hôm nay và trong kỳ gói.

9. Lỗi thường gặp

401 là sai key, 403 là key/gói hết hạn, 429 là vượt quota, 500 là lỗi router hoặc proxy.