Hoppa till huvudinnehåll
Claude Messages Count Tokens API kan beräkna antalet input-token för ett Message utan att faktiskt skapa ett meddelande, inklusive tokenräkning för innehåll såsom verktyg, bilder och dokument. Detta är mycket användbart när du behöver uppskatta kostnader eller kontrollera om indata överskrider modellens kontextgräns. Detta dokument introducerar främst användningsprocessen för Claude Messages Count Tokens API.

Ansökningsprocess

För att använda Claude Messages Count Tokens API går du först till Ace Data Cloud-konsolen för att hämta din API Token och behåller den som reserv. Om du ännu inte har loggat in eller registrerat dig, omdirigeras du automatiskt till inloggningssidan där du uppmanas att registrera dig och logga in, och när detta är klart återgår du automatiskt till den aktuella sidan. En API Token kan anropa alla plattformens tjänster, utan att behöva ansöka separat för varje tjänst. Vid första ansökan får du en kostnadsfri kvot för att kunna prova gratis; när kvoten är otillräcklig kan du fylla på det gemensamma saldot i konsolen.
📘 Fullständig dokumentation: Claude Messages Count Tokens API →

Grundläggande användning

Claude Messages Count Tokens API:s begärandesökväg är /v1/messages/count_tokens, vilket är konsekvent med Anthropic:s officiella API. Vi behöver minst ange två obligatoriska parametrar:
  • model: Välj Claude-modellen som ska användas; claude-opus-5-5 kan användas för Messages Token Count, såsom den senaste flaggskeppsmodellen claude-fable-5-1; den tidigare claude-fable-5 är fortfarande kompatibel och behålls. claude-sonnet-5-5 har lagts till i det inbyggda Messages-seriegränssnittet och stöder bildindata och adaptivt tänkande; dess officiella referenspriser för indata, utdata och cacheläsning är 2, 10 respektive 0,20 USD per miljon Token.
  • messages: Indatameddelandenas array, där varje meddelande innehåller role (roll) och content (innehåll).
Vanliga valfria parametrar:
  • system: Systemprompt, räknas in i antalet Token.
  • tools: Verktygsdefinitioner, räknas in i antalet Token.
  • thinking: Konfiguration för utökat tänkande.
  • tool_choice: Konfiguration för val av verktyg.
  • cache_control: Cachekontrollkonfiguration på toppnivå eller innehållsblocknivå.
messages, system, återspelning av verktygsanrop, URL-bilder och innehållsblock för document/PDF använder samma stabila begärandestruktur som Messages API.

cURL-exempel

Python-exempel

Exempel på returnerat resultat:

Användning av Anthropic SDK

Claude Messages Count Tokens API accepterar Anthropic SDK:s stabila begärandestruktur och kan anropas via biblioteket anthropic. Gränssnittet använder den valda modellens motsvarande inbyggda Count Tokens-funktion för att räkna indata och kan användas för att kontrollera indatans storlek innan en Messages-begäran skickas.

Tokenräkning som inkluderar verktyg

Om din begäran innehåller verktygsdefinitioner räknas även dessa verktyg in i antalet Token:

Tokenräkning som inkluderar systemprompt

Systemprompten räknas också in i antalet Token:

Anmärkningar

  • Detta API beräknar endast antalet input-token och genererar ingen modellutdata.
  • Tokenräkningsresultatet kan användas för att uppskatta indatans storlek och kontrollera kontextfönstret; slutlig debitering baseras på usage i det faktiska Messages-svaret.
  • Bilder, PDF:er, verktygsdefinitioner, systemprompter och thinking-konfigurationer räknas in i resultatet enligt den valda modellens indateregler.
  • Detta API är helt kostnadsfritt och förbrukar ingen kvot.