# Bắt đầu nhanh

Nguồn: https://docs.openaihub.net/quickstart/

## Chuẩn bị API key

Mở [OpenAiHub](https://openaihub.net), đă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](https://t.me/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:

```bash
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

```bash
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:

```bash
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.

```bash
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](https://docs.openaihub.net/troubleshooting/). 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.