Teks

Menghitung Token Pesan

Menghitung token input dari permintaan Pesan tanpa membuat respons.

POST
/v1/messages/count_tokens

Gambaran Umum

Kirimkan kolom model, messages, system, tools, dan thinking yang sama seperti pada Buat Message, tanpa max_tokens, untuk menghitung token input sebelum Anda mengirim permintaan. Model harus mencantumkan anthropic_messages di dalam accepted_request_formats.

Catatan

  • Penghitungan token memerlukan API key dan tidak dikenakan biaya.
  • Penghitungan ini ditujukan untuk perencanaan. Biaya untuk permintaan yang sebenarnya berasal dari usage dalam responsnya.
  • TokenLab lebih memilih penghitungan dari penghitung milik model itu sendiri. Jika penghitung tersebut tidak tersedia, TokenLab akan mengembalikan estimasi lokal dan menetapkan header respons X-TokenLab-Count-Tokens-Source: local_estimate.
  • Autentikasi, izin, dan kesalahan input tetap akan menyebabkan kegagalan. Permintaan yang mereferensikan file_id memerlukan penghitung milik model dan akan mengembalikan 503 jika tidak ada yang tersedia. Kirim anthropic-beta: files-api-2025-04-14 bersama permintaan tersebut.

Contoh

Permintaan

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!"}
    ]
  }'

Contoh respons

Respons

200 OK
{
  "input_tokens": 12
}

Kolom penting

input_tokensinteger
Perkiraan jumlah token input dalam permintaan.

Otorisasi

BearerAuth
AuthorizationBearer <token>

Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.

Lokasi: header

Body permintaan

application/json

Respons

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json