Bắt đầu
Bắt đầu nhanh
Thực hiện yêu cầu API TokenLab đầu tiên của bạn bằng cURL, Python, JavaScript, Go hoặc PHP. Thiết lập API key, cấu hình endpoint và xác minh phản hồi Chat Completions.
Nhận API key
Tạo tài khoản
Đăng ký tại tokenlab.sh bằng email, tài khoản Google hoặc GitHub của bạn.
Tạo và lưu API key
Mở API Keys trong workspace của bạn. Tạo một key và lưu lại giá trị đầy đủ ngay lập tức; nó chỉ được hiển thị một lần duy nhất. Nếu bạn đã lưu một key đầy đủ, hãy sử dụng giá trị đó. Tiền tố được hiển thị hoặc sao chép từ danh sách không thể dùng để xác thực các yêu cầu.
Kiểm tra số dư workspace
Kiểm tra số dư của bạn trong Billing. Tài khoản mới có thể nhận được tín dụng dùng thử một lần; nếu không, số dư sẽ bắt đầu ở mức $0 và cần nạp tiền (tối thiểu $5) trước khi thực hiện yêu cầu đầu tiên. Yêu cầu sẽ được tính phí theo giá hiện tại của model đã chọn.
Hãy giữ bí mật API key. Không đặt nó trong mã nguồn phía client hoặc kho lưu trữ công khai.
Thiết lập key cho terminal này
Các lệnh dưới đây giữ cho key không bị lộ trong chính câu lệnh. Chúng chỉ thiết lập key cho terminal hiện tại và các tiến trình con của nó. Hãy sử dụng trình quản lý bí mật (secret manager) cho các ứng dụng đã triển khai.
printf 'TokenLab API key: '
read -r -s TOKENLAB_API_KEY
printf '\n'
export TOKENLAB_API_KEYCài đặt client
pip install openaiGửi yêu cầu đầu tiên của bạn
Đối với hầu hết các tích hợp mới, hãy bắt đầu với Chat Completions tại 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 dưới dạng quickstart.py, quickstart.mjs, main.go hoặc quickstart.php, sau đó chạy python quickstart.py, node quickstart.mjs, go run . hoặc php quickstart.php. Python, JavaScript và Go sử dụng các SDK chính thức của OpenAI; PHP sử dụng OpenAI PHP client do cộng đồng duy trì (PHP 8.2+).
Chỉ sử dụng POST /v1/responses khi bạn cần hành vi dành riêng cho Responses. Việc hỗ trợ các trường chỉ dành cho Responses phụ thuộc vào model được chọn.
Xác nhận kết quả
Một yêu cầu thành công sẽ trả về câu trả lời không trống. Mở Runs trong cùng workspace để kiểm tra model, trạng thái và mức sử dụng. Đối với các lỗi, hãy làm theo hướng dẫn xử lý sự cố. Việc thay đổi model hoặc thêm streaming là một bước tiếp theo riêng biệt trong hướng dẫn SDK.
Tại sao cuộc gọi đầu tiên của tôi trả về 402?
Việc cuộc gọi đầu tiên của bạn có hoạt động hay không phụ thuộc vào số dư hiển thị trong Billing. Trong thời gian ưu đãi tín dụng dùng thử, một tài khoản mới đủ điều kiện sẽ nhận được $0.25 một lần, cho tối đa 10 cuộc gọi trong vòng 7 ngày; cuộc gọi thứ 11 sẽ trả về 402 và thông báo rằng các cuộc gọi dùng thử miễn phí đã hết, ngay cả khi vẫn còn một ít tín dụng. Một tài khoản có số dư $0 sẽ nhận được HTTP 402 với mã lỗi insufficient_balance. Hãy nạp ít nhất $5 trong Billing; $5 là mức nạp tối thiểu. Sau đó, hãy gửi lại cùng một yêu cầu. Bạn không cần API key mới: key bạn đã tạo sẽ tiếp tục hoạt động sau khi số dư đủ để chi trả cho yêu cầu.
Một cuộc gọi kiểm tra đầu tiên tốn rất ít chi phí. Một ví dụ yêu cầu tới deepseek-v4.1-flash có chi phí thấp hơn nhiều so với $0.01.
Nếu bạn đã có sẵn số dư, thông báo 402 sẽ cho biết yêu cầu cần bao nhiêu và số dư hiện tại của bạn là bao nhiêu. TokenLab giữ chi phí của toàn bộ max_tokens trước khi cuộc gọi bắt đầu, vì vậy một đầu vào dài hoặc max_tokens lớn có thể cần nhiều hơn số dư nhỏ. Trên /v1/chat/completions và /v1/messages, khi một max_tokens nhỏ hơn là đủ, thông báo cũng sẽ cung cấp giá trị để bạn giảm xuống. Khi chỉ riêng đầu vào đã tốn nhiều hơn số dư của bạn, thông báo sẽ yêu cầu bạn rút ngắn đầu vào thay vì giảm max_tokens.
Một key đạt đến giới hạn chi tiêu của chính nó cũng sẽ trả về 402, với mã quota_exceeded. Hãy tăng hoặc xóa giới hạn trong phần API Keys. Để xử lý 402 trong mã nguồn, hãy xem xử lý lỗi.