Bắt đầu
Bắt đầu nhanh
Gửi yêu cầu TokenLab API đầu tiên bằng cURL, Python, JavaScript, Go hoặc PHP. Thiết lập khóa API và endpoint, chạy ví dụ Chat Completions và kiểm tra phản hồi.
Bước 1: Tạo tài khoản và nạp tiền
Tạo tài khoản
Đăng ký tại tokenlab.sh bằng email, Gmail hoặc tài khoản GitHub của bạn.
Kiểm tra số dư không gian làm việc
Kiểm tra số dư hiện có trong Thanh toán. Yêu cầu được tính phí theo giá hiện tại của mô hình; nạp thêm nếu cần.
Tạo và lưu khóa API
Mở Khóa API trong không gian làm việc. Tạo khóa và lưu ngay giá trị đầy đủ; giá trị này chỉ hiển thị một lần. Nếu đã lưu một khóa đầy đủ, hãy dùng giá trị đó. Tiền tố hiển thị hoặc sao chép từ danh sách không thể dùng để xác thực yêu cầu.
Giữ khóa API của bạn an toàn. Không bao giờ để lộ nó trong mã phía client hoặc kho lưu trữ công cộng.
Đặt khóa cho terminal hiện tại
Các lệnh sau không đưa khóa vào nội dung lệnh. Khóa chỉ áp dụng cho terminal hiện tại và các tiến trình con. Khi triển khai ứng dụng, dùng trình quản lý bí mật.
printf 'TokenLab API key: '
read -r -s TOKENLAB_API_KEY
printf '\n'
export TOKENLAB_API_KEYBước 2: Cài đặt client
pip install openaiBước 3: Thực hiện yêu cầu đầu tiên
Đối với hầu hết các tích hợp mới, bắt đầu với Chat Completions qua POST /v1/chat/completions.
curl https://api.tokenlab.sh/v1/chat/completions \
-H "Authorization: Bearer $TOKENLAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6-terra","messages":[{"role":"user","content":"Reply only with OK."}]}'Lưu một ví dụ SDK thành quickstart.py, quickstart.mjs, main.go hoặc quickstart.php, rồi chạy python quickstart.py, node quickstart.mjs, go run . hoặc php quickstart.php. Python, JavaScript và Go dùng SDK chính thức của OpenAI; PHP dùng client cộng đồng, yêu cầu PHP 8.2+.
Chỉ sử dụng POST /v1/responses khi bạn thực sự cần hành vi đặc thù của Responses. Một số trường chỉ dành cho Responses phụ thuộc vào model được chọn và đường dẫn được định tuyến.
Kiểm tra kết quả
Yêu cầu thành công trả về câu trả lời không rỗng. Kiểm tra mô hình, trạng thái và mức sử dụng trong Yêu cầu của cùng không gian làm việc. Xem xử lý sự cố khi có lỗi và hướng dẫn SDK để đổi mô hình hoặc dùng streaming.