Zum Hauptinhalt springen
Die Claude Messages Count Tokens API kann die Anzahl der Eingabe-Tokens einer Message berechnen, einschließlich der Token-Zählung für Inhalte wie Tools, Bilder und Dokumente, ohne tatsächlich eine Nachricht zu erstellen. Dies ist sehr nützlich, wenn Kosten geschätzt oder überprüft werden müssen, ob die Eingabe die Kontextbegrenzung des Modells überschreitet. Dieses Dokument stellt hauptsächlich den Nutzungsprozess der Claude Messages Count Tokens API vor.

Beantragungsprozess

Um die Claude Messages Count Tokens API zu verwenden, rufen Sie zunächst in der Ace Data Cloud-Konsole Ihren API-Token ab und bewahren Sie ihn zur späteren Verwendung auf. Falls Sie noch nicht angemeldet oder registriert sind, werden Sie automatisch zur Anmeldeseite weitergeleitet, um sich zu registrieren und anzumelden. Nach Abschluss kehren Sie automatisch zur aktuellen Seite zurück. Ein API-Token kann alle Dienste der Plattform aufrufen, ohne dass er für jeden Dienst separat beantragt werden muss. Bei der ersten Beantragung wird ein kostenloses Guthaben vergeben, mit dem Sie den Dienst kostenlos ausprobieren können; bei unzureichendem Guthaben können Sie in der Konsole ein universelles Guthaben aufladen.
📘 Vollständige Dokumentation: Claude Messages Count Tokens API →

Grundlegende Verwendung

Der Anfragepfad der Claude Messages Count Tokens API lautet /v1/messages/count_tokens und stimmt mit der offiziellen Anthropic API überein. Wir müssen mindestens zwei Pflichtparameter bereitstellen:
  • model: Wählen Sie das zu verwendende Claude-Modell aus; claude-opus-5-5 kann für Messages Token Count verwendet werden, ebenso wie das neueste Flaggschiff claude-fable-5-1; das ursprüngliche claude-fable-5 bleibt weiterhin kompatibel erhalten. claude-sonnet-5-5 wurde zur nativen Messages-Serienschnittstelle hinzugefügt und unterstützt Bildeingaben sowie adaptives Denken; die offiziellen Referenzpreise für Eingabe, Ausgabe und Cache-Lesen betragen jeweils 2, 10 und 0,20 US-Dollar pro Million Tokens.
  • messages: Das Array der eingegebenen Nachrichten, wobei jede Nachricht role (Rolle) und content (Inhalt) enthält.
Häufig verwendete optionale Parameter:
  • system: System-Prompt, wird bei der Token-Anzahl berücksichtigt.
  • tools: Tool-Definitionen, werden bei der Token-Anzahl berücksichtigt.
  • thinking: Konfiguration für erweitertes Denken.
  • tool_choice: Konfiguration für die Tool-Auswahl.
  • cache_control: Cache-Steuerungskonfiguration auf oberster Ebene oder auf Inhaltblockebene.
messages, system, die Wiedergabe von Tool-Aufrufen, URL-Bilder und document/PDF-Inhaltsblöcke verwenden dieselbe stabile Anfragestruktur wie die Messages API.

cURL-Beispiel

Python-Beispiel

Beispiel für das Rückgabeergebnis:

Verwendung des Anthropic SDK

Die Claude Messages Count Tokens API akzeptiert die stabile Anfragestruktur des Anthropic SDK und kann über die Bibliothek anthropic aufgerufen werden. Die Schnittstelle verwendet die native Count-Tokens-Funktion des ausgewählten Modells, um Eingaben zu zählen, und kann verwendet werden, um die Eingabegröße vor dem Senden einer Messages-Anfrage zu überprüfen.

Token-Zählung mit Tools

Wenn Ihre Anfrage Tool-Definitionen enthält, werden diese Tools ebenfalls bei der Token-Anzahl berücksichtigt:

Token-Zählung mit System-Prompt

Der System-Prompt wird ebenfalls bei der Token-Anzahl berücksichtigt:

Hinweise

  • Diese API berechnet nur die Anzahl der Eingabe-Tokens und erzeugt keinerlei Modellausgabe.
  • Das Token-Zählergebnis kann zur Schätzung der Eingabegröße und zur Überprüfung des Kontextfensters verwendet werden; die endgültige Abrechnung richtet sich nach usage in der tatsächlichen Messages-Antwort.
  • Bilder, PDFs, Tool-Definitionen, System-Prompts und die thinking-Konfiguration werden gemäß den Eingaberegeln des ausgewählten Modells in das Ergebnis einbezogen.
  • Diese API ist vollständig kostenlos und verbraucht keinerlei Guthaben.