Bắt đầu nhanh

Trang này đi theo lộ trình ngắn nhất để chạy được một lần gọi mô hình. Sau đó bạn có thể đọc từng trang tính năng trong Hướng dẫn người dùng khi cần.

Điều kiện cần

Một tài khoản Glacier AI. Khi đăng ký có thể cần xác minh email.
Tài khoản có hạn mức khả dụng. Nếu tài khoản mới có số dư bằng 0, hãy nạp tiền hoặc dùng mã đổi thưởng trong Ví trước.

Ví dụ trong trang này dùng địa chỉ https://api.example.com — hãy thay bằng địa chỉ bạn thực sự truy cập.

Bước 1: Đăng ký và đăng nhập

Mở trang chủ, bấm «Đăng nhập» ở góc trên bên phải hoặc truy cập thẳng /sign-in.
Nếu chưa có tài khoản, bấm «Đăng ký» hoặc truy cập /sign-up, nhập tên đăng nhập và mật khẩu, hoàn tất xác minh email và kiểm tra chống bot nếu được yêu cầu.
Sau khi đăng nhập bạn vào bảng điều khiển. Thanh điều hướng bên trái hiển thị các mô-đun tài khoản của bạn được dùng.

Chi tiết xem Đăng ký và đăng nhập.

Bước 2: Tạo khóa API

Bấm «Khóa API» trên thanh điều hướng bên trái hoặc truy cập /keys.
Bấm «Tạo khóa API» và nhập tên (nên đặt theo mục đích, ví dụ «Sản xuất» hoặc «Kiểm thử»).
Thiết lập hạn mức, thời hạn, giới hạn mô hình, nhóm và danh sách IP cho phép nếu cần. Khi chưa chắc chắn, để trống tất cả nghĩa là không giới hạn.
Sau khi lưu, xem và sao chép khóa đầy đủ trong danh sách, dạng sk-xxxxxxxx.

Chi tiết xem Khóa API.

Bước 3: Gửi yêu cầu đầu tiên

Nền tảng cung cấp API tương thích OpenAI. Chỉ cần đổi Base URL của SDK chính thức thành địa chỉ trang của bạn cộng /v1.

curl https://api.example.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "Xin chào"}]
  }'

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxx",
    base_url="https://api.example.com/v1",
)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Xin chào"}],
)
print(response.choices[0].message.content)

Nếu không muốn viết mã, hãy bấm «Playground» trên thanh điều hướng bên trái (/playground) để chọn mô hình và trò chuyện ngay trên trình duyệt.

Bước 4: Kiểm tra mức sử dụng và tính phí

Bấm «Nhật ký sử dụng» trên thanh điều hướng bên trái hoặc truy cập /usage-logs/common.
Tìm bản ghi của yêu cầu vừa gửi và kiểm tra mô hình, số token, thời lượng và hạn mức bị trừ.
Bấm vào bản ghi để mở chi tiết: mã yêu cầu, ánh xạ mô hình, chi tiết tính phí và nhiều thông tin khác.

Chi tiết xem Nhật ký và tác vụ bất đồng bộ.

Sự cố thường gặp

Hiện tượng	Hướng kiểm tra
Trả về 401 chưa xác thực	Kiểm tra định dạng `Authorization: Bearer <khóa>`, khóa đã bật chưa và đã hết hạn chưa.
Trả về 403 bị từ chối	Kiểm tra giới hạn mô hình, quyền theo nhóm và danh sách IP cho phép của khóa.
Báo không đủ hạn mức	Kiểm tra số dư hoặc hạn mức gói đăng ký trong Ví, cùng với hạn mức tối đa đặt trên chính khóa.
Báo mô hình không tồn tại	Kiểm tra trong Thư viện mô hình xem mô hình đã bật chưa và nhóm hiện tại có dùng được không.
Không thấy bản ghi trong nhật ký	Nhật ký ghi trễ vài giây, hãy chờ rồi tải lại. Không phải phản hồi thất bại nào cũng tạo bản ghi lỗi.

Bước tiếp theo

Tổng quan hướng dẫn: mục lục toàn bộ tính năng và thứ tự đọc được khuyến nghị.
Sử dụng API và Playground: toàn bộ endpoint được hỗ trợ và cách gọi theo định dạng gốc.
Tích hợp ứng dụng chat: đưa cấu hình vào các ứng dụng AI quen dùng chỉ với một thao tác.