Tài liệu

Hướng dẫn dùng TokenHub API

Từ tài khoản mới đến request đầu tiên, với cấu hình an toàn cho môi trường production.

1. Tạo tài khoản và khóa API

Mở trang đăng ký, xác nhận tài khoản rồi tạo khóa riêng cho ứng dụng. Không đưa khóa API vào mã nguồn hoặc ứng dụng phía trình duyệt.

2. Cấu hình SDK

export OPENAI_API_KEY="sk-..."
export OPENAI_BASE_URL="https://api.moli4.com/v1"

Với SDK OpenAI, đặt base_url theo endpoint hiển thị trong bảng điều khiển. Model ID phải thuộc nhóm gắn với khóa.

3. Gọi API thử

curl "$OPENAI_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"MODEL_ID","messages":[{"role":"user","content":"Viết một câu chào bằng tiếng Việt"}]}'

4. Chuẩn bị production

  • Đặt timeout và retry có backoff.
  • Không ghi nội dung nhạy cảm hoặc khóa API vào log.
  • Đặt hạn mức theo khóa và cảnh báo chi phí.
  • Lưu request ID để hỗ trợ điều tra lỗi.
  • Kiểm tra trạng thái API khi có sự cố.

Bắt đầu với một khóa API

Tạo tài khoản, chọn nhóm mô hình và theo dõi mức sử dụng trong cùng một bảng điều khiển.

Tạo tài khoản