Text & Chat

Nachrichten-Tokens zählen

Zählt die Eingabe-Tokens einer Messages-Anfrage, ohne eine Antwort zu erstellen.

POST
/v1/messages/count_tokens

Überblick

Senden Sie dieselben Felder model, messages, system, tools und thinking wie bei Nachricht erstellen, jedoch ohne max_tokens, um die Eingabe-Tokens vor dem Senden der Anfrage zu zählen. Das Modell muss anthropic_messages in accepted_request_formats auflisten.

Hinweise

  • Das Zählen von Tokens erfordert einen API-Key und wird nicht in Rechnung gestellt.
  • Die Zählung dient der Planung. Die Abrechnung für die tatsächliche Anfrage erfolgt über die usage in der entsprechenden Antwort.
  • TokenLab bevorzugt eine Zählung durch den eigenen Zähler des Modells. Wenn dieser Zähler nicht verfügbar ist, gibt TokenLab eine lokale Schätzung zurück und setzt den Antwort-Header X-TokenLab-Count-Tokens-Source: local_estimate.
  • Authentifizierungs-, Berechtigungs- und Eingabefehler führen weiterhin zu einem Fehler. Eine Anfrage, die auf eine file_id verweist, benötigt den eigenen Zähler des Modells und gibt 503 zurück, wenn keiner verfügbar ist. Senden Sie anthropic-beta: files-api-2025-04-14 bei einer solchen Anfrage mit.

Beispiel

Anfrage

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

Antwortbeispiel

Antwort

200 OK
{
  "input_tokens": 12
}

Wichtige Felder

input_tokensinteger
Geschätzte Anzahl der Eingabe-Tokens in der Anfrage.

Autorisierung

BearerAuth
AuthorizationBearer <token>

API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.

Ort: header

Anfragekörper

application/json

Antwort

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json