TokenLab

Văn bản

Đếm Token Tin nhắn

Đếm số lượng token đầu vào của một yêu cầu Messages mà không tạo phản hồi.

POST
/v1/messages/count_tokens

Tổng quan

Gửi các trường model, messages, system, tools, và thinking tương tự như Tạo Tin nhắn, nhưng không bao gồm max_tokens, để đếm số lượng token đầu vào trước khi bạn gửi yêu cầu. Model phải liệt kê anthropic_messages trong accepted_request_formats.

Lưu ý

  • Việc đếm token cần có API key và không bị tính phí.
  • Số lượng đếm chỉ mang tính chất lập kế hoạch. Phí cho yêu cầu thực tế sẽ dựa trên usage trong phản hồi của yêu cầu đó.
  • TokenLab ưu tiên sử dụng bộ đếm của chính model. Khi bộ đếm đó không khả dụng, TokenLab sẽ trả về ước tính cục bộ và thiết lập header phản hồi X-TokenLab-Count-Tokens-Source: local_estimate.
  • Các lỗi về xác thực, quyền truy cập và đầu vào vẫn sẽ gây lỗi yêu cầu. Một yêu cầu tham chiếu đến file_id cần bộ đếm của chính model và sẽ trả về 503 khi không có bộ đếm nào khả dụng. Hãy gửi anthropic-beta: files-api-2025-04-14 cùng với yêu cầu đó.

Ví dụ

Yêu cầu

cURL
curl -X POST "https://api.tokenlab.sh/v1/messages/count_tokens" \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [
      {"role": "user", "content": "Hello, Claude!"}
    ]
  }'

Ví dụ phản hồi

Phản hồi

200 OK
{
  "input_tokens": 12
}

Các trường quan trọng

input_tokensinteger
Số lượng token đầu vào ước tính trong yêu cầu.

Xác thực

BearerAuth
AuthorizationBearer <token>

Xác thực bằng Khóa API. Tạo hoặc quản lý khóa API trong Dashboard > API > API Keys.

Vị trí: header

Nội dung yêu cầu

application/json

Phản hồi

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json