Bắt đầu nhanh

Chuẩn bị API key

Mở OpenAiHub, đăng nhập hoặc đăng ký tài khoản. Trong bảng điều khiển, tìm mục quản lý API key/token và tạo key theo quyền truy cập tài khoản của bạn. Nếu chưa thấy mục này, liên hệ @muataikhoan_sp.

Không gửi API key cho AI, không đăng lên GitHub và không nhúng trong mã frontend. Các ví dụ dưới đây dùng biến môi trường trên máy của bạn.

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

Trên macOS/Linux, nhập key ở chế độ ẩn để tránh lưu key trong lịch sử shell:

read -rs OPENAI_API_KEY
export OPENAI_API_KEY

Dán key, nhấn Enter. Lệnh nhập ẩn này không hiển thị ký tự khi gõ.

Lấy danh sách model

curl --fail-with-body https://api.openaihub.net/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY"

Chọn một giá trị id trong kết quả và đặt biến:

export OPENAI_MODEL="MODEL_ID_FROM_YOUR_ACCOUNT"

MODEL_ID_FROM_YOUR_ACCOUNT là chỗ giữ chỗ, không phải model thật. Không tự dùng một model chỉ vì công cụ có sẵn tên đó.

Gửi yêu cầu chat

Ví dụ dưới đây dành cho model hỗ trợ giao thức Chat Completions. Danh sách model không bảo đảm mọi model đều dùng được endpoint này.

curl --fail-with-body https://api.openaihub.net/v1/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"$OPENAI_MODEL\",\"messages\":[{\"role\":\"user\",\"content\":\"Xin chào!\"}]}"

Với phản hồi Chat Completions thành công, nội dung văn bản thường nằm ở choices[0].message.content.

Khi chưa kết nối được

Xem Xử lý lỗi. Quyền model, số dư và giao thức khả dụng phụ thuộc tài khoản. Nếu model yêu cầu giao thức khác, hỏi hỗ trợ thay vì thử đổi endpoint ngẫu nhiên.