Modelle mit GET /v1/models auflisten, um die exakte Modell-id zu finden

Dein Code gibt einen 404 für einen Modellnamen zurück, der in einem fremden Beispiel unproblematisch aussah. Frag die API selbst: Eine einzige GET-Anfrage an https://api.cheaptokens.dev/v1/models listet die Modelle auf, die du aufrufen kannst, mit ihren Kontext- und Ausgabelimits. Kopiere die id aus dieser Antwort, nicht aus dem Gedächtnis, und prüfe das Limit, bevor du max_tokens setzt.

Die Docs-Seite (CheapTokens docs, geprüft am 28. Oktober 2026) beschreibt GET /v1/models als die Liste der aufrufbaren Modelle mit Kontext- und Ausgabelimits. Daneben stehen GET /v1/models/{model} für ein einzelnes Modell und GET /v1/capabilities. Der Chat selbst läuft über POST /v1/chat/completions (OpenAI-kompatibel) oder POST /v1/messages (Anthropic-kompatibel).

Warum dasselbe Modell überall eine andere id hat#

Angenommen, du findest ein Tutorial für einen anderen Anbieter. Es verwendet model: "deepseek-chat", du fügst es neben die CheapTokens-Base-URL ein, und die Anfrage schlägt fehl. Mit deinem Key ist nichts falsch. Anbieter benennen dasselbe Modell unterschiedlich: ein Präfix wie deepseek-ai/, ein Versionssuffix wie -0731, andere Groß-/Kleinschreibung. Die API akzeptiert nur den exakten String, den sie auflistet, und ein Kurzname aus einem Preislabel funktioniert ebenfalls nicht.

Genau deshalb lohnt es sich, die id einmal nachzuschlagen. Wenn du die ganze Geschichte lesen willst, wie eine falsche id auf dem Bildschirm aussieht, führt dich API 401 oder 404 Fehler: falscher Key, Base-URL oder Modell-id durch. Dieser Leitfaden ist der Schritt davor: Finde die richtige id, damit du diesen Fehler nie siehst.

Frag die API: eine Anfrage#

Wähle den Tab, den du verwendest. Beide senden dieselbe Anfrage. In beiden Beispielen kommt der Key aus der Umgebungsvariable CHEAPTOKENS_API_KEY (der Key steht im Dashboard, sobald Guthaben auf dem Konto ist).

export CHEAPTOKENS_API_KEY="sk-your-key"

curl https://api.cheaptokens.dev/v1/models \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY"

import json
import os

import requests

resp = requests.get(
    "https://api.cheaptokens.dev/v1/models",
    headers={"Authorization": f"Bearer {os.environ['CHEAPTOKENS_API_KEY']}"},
    timeout=30,
)
resp.raise_for_status()
print(json.dumps(resp.json(), indent=2))

Die Python-Version gibt das rohe JSON absichtlich aus. Lies es einmal mit eigenen Augen: Du suchst die Modell-ids und daneben die Kontext- und Ausgabelimits. Kopiere jede id vollständig aus der Ausgabe.

Die drei ids und ihre Limits#

Die Docs listen diese aufrufbaren Modelle auf (geprüft am 28. Oktober 2026). Sende den String in Code-Formatierung am Anfang jeder Zeile als model:

• zai-org/GLM-5.3-Flash — 390K Kontext, bis zu 8.192 Ausgabe-Tokens.
• deepseek-ai/DeepSeek-V4-Flash-0731 — 380K Kontext, bis zu 32.768 Ausgabe-Tokens.
• MiniMaxAI/MiniMax-M2.7 — 180K Kontext, bis zu 8.192 Ausgabe-Tokens.

Zwei Zahlen sind für die meisten Entscheidungen wichtig. Kontext ist, wie viel das Modell in einer Anfrage aufnehmen kann, dein Prompt und seine Antwort zusammen. Das Ausgabelimit ist die längste einzelne Antwort. Wenn diese Begriffe neu für dich sind, erklären wie man AI-Modellnamen liest und warum eine Antwort mitten im Satz stoppt sie in einfacher Sprache.

Wähle ein erstes Modell für deine Aufgabe#

Du brauchst keine lange Benchmark-Studie, um anzufangen. Zwei Fragen klären die meisten ersten Entscheidungen: Wie groß ist deine Eingabe, und wie lang muss die Antwort sein? Klicke auf den Fall, der deinem am nächsten kommt.

Alle drei teilen sich ein Guthaben und einen Preis zu jeder Tageszeit, ohne Stoßzeiten, sodass ein späterer Wechsel nur einen geänderten String kostet. Im Vergleich zu OpenRouter ist jedes der drei insgesamt günstiger, wobei Eingabe und Ausgabe zusammen gezählt werden. So sieht eine Workload aus: Angenommen, du betreibst einen kleinen Assistenten, der 2.000 Eingabe-Tokens sendet und 500 zurückbekommt, 1.000 Mal am Tag. Die Live-Tabelle unten bepreist genau das.

Aktuelle Preise pro Token für jedes Modell stehen auf der Preisseite, und die Modellseiten gehen tiefer auf jedes einzelne ein. Wenn du einen Vergleich nach Aufgabe willst, gibt es GLM vs DeepSeek vs MiniMax: welches Modell wählen.

Setze max_tokens aus dem Limit, dann sende die Anfrage#

Ein häufiger Fehler: Du forderst einen langen Bericht von einem Modell an, dessen Limit 8.192 ist, und die Antwort stoppt auf halbem Weg. Das Limit, das du in der Liste gesehen hast, ist die Obergrenze für max_tokens. Bleib darunter oder genau darauf.

Hier ist eine Anfrage mit der vollständigen id aus der Liste. Sie fordert eine lange Antwort von dem Modell an, das sie erlaubt:

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "messages": [{"role": "user", "content": "Write a 1,500-word guide to API keys."}],
    "max_tokens": 4000
  }'

Neu beim ersten Aufruf? Deine erste API-Anfrage mit CheapTokens behandelt das Antwortformat und das Feld usage.

Um die Routine zu festigen, bringe die Schritte in die richtige Reihenfolge:

Wenn die Anfrage trotzdem fehlschlägt#

Beginne mit dem String. Eine Modell-id, die sich um ein Zeichen unterscheidet, ist die übliche Ursache für einen 404, also füge sie erneut aus der Liste ein, statt sie neu zu tippen. Ein 402 bedeutet, dass das Guthaben erschöpft ist, und das Rate-Limit liegt bei 120 Anfragen pro Minute pro API-Key. Fehler kommen im standardmäßigen OpenAI/Anthropic-JSON-Format zurück, sodass SDKs sie wie gewohnt parsen. Für die vollständige Durchführung siehe API 401 oder 404 Fehler.

Die API ist OpenAI- und Anthropic-kompatibel unter https://api.cheaptokens.dev/v1; Anthropic-SDKs und Claude Code verwenden die Root-URL https://api.cheaptokens.dev ohne /v1. Weitere Setup-Details stehen in den Docs.