Erste Anfrage an eine OpenAI-kompatible API in Postman

Du hast einen API-Schlüssel und willst sehen, was tatsächlich über die Leitung geht, bevor du eine Zeile Code schreibst. Postman ist genau dafür gut: Du trägst eine URL, einen Schlüssel und einen JSON-Body ein, drückst Send, und die Antwort erscheint direkt darunter. Bei CheapTokens ist die Anfrage POST https://api.cheaptokens.dev/v1/chat/completions mit einem Authorization: Bearer-Schlüssel und einem JSON-Body, der das Modell benennt.

Die folgenden Schritte folgen Postmans eigener Doku (v12, die neueste Version auf der Doku-Seite, geprüft am 31. Oktober 2026). Wenn du ein Terminal bevorzugst, findest du dieselbe Anfrage in Your first API request with CheapTokens.

In vier Schritten eingerichtet#

Du brauchst nur wenige Dinge: die Basis-URL, deinen Schlüssel, eine Modell-ID und eine Nachricht. Postman hält die ersten beiden in Variablen, sodass der Schlüssel nie direkt in die Anfrage eingefügt wird.

Ein paar Details zu jedem Schritt.

Die Anfrage erstellen. Klicke auf das Add-Symbol in der linken Seitenleiste und wähle HTTP. Das Methoden-Dropdown steht standardmäßig auf GET, also stelle es auf POST um und gib die URL ein. Postman-Variablen schreibt man als {{variable_name}}; die Doku verwendet {{base_url}} als Beispiel. Definiere base_url als https://api.cheaptokens.dev/v1, und das URL-Feld wird zu {{base_url}}/chat/completions. Postman speichert Variablen als Strings, was hier in Ordnung ist.

Den Schlüssel hinzufügen. Öffne den Tab Authorization, wähle Bearer Token im Dropdown Auth Type und trage {{api_key}} in das Feld Token ein. Postman sendet ihn als Authorization-Header im Bearer-Format. Die Doku empfiehlt genau das: den Token in einer Variable halten und ihn über den Namen referenzieren. Warum diese Gewohnheit wichtig ist, steht in Store an API key safely.

Den Body schreiben. Wähle im Tab Body raw und dann JSON im Dropdown. Bei Raw-Bodies setzt Postman den passenden Content-Type selbst, du fügst diesen Header also nicht hinzu. Füge Folgendes ein:

{
  "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
  "messages": [
    { "role": "user", "content": "Explain in one sentence what a token is." }
  ],
  "max_tokens": 200
}

Die Modell-ID ist die vollständige gateway_id aus der CheapTokens-Doku; ein Kurzname wie deepseek-flash wird nicht akzeptiert. max_tokens begrenzt die Länge der Antwort, sodass ein erster Test nicht zu lang laufen kann. Noch ein Postman-Detail: //- und /* */-Kommentare in einem JSON-Body werden vor dem Senden entfernt, du kannst den Body also für einen Kollegen annotieren.

Send drücken und die Antwort lesen#

Wenn alles stimmt, zeigt der Antwortbereich ein JSON-Objekt im OpenAI-Chat-Completions-Format. Zwei Stellen sind wichtig:

• choices[0].message.content ist der Antworttext.
• usage enthält prompt_tokens (was du gesendet hast) und completion_tokens (was das Modell geschrieben hat). Dafür wird dir berechnet, also schau dir das schon bei der allerersten Anfrage an.

Prüfe außerdem choices[0].finish_reason. stop bedeutet, dass das Modell von selbst fertig wurde; length bedeutet, dass die Antwort max_tokens erreicht hat und abgeschnitten wurde. Wenn du das siehst, erhöhe das Limit oder lies AI answer cut off? Fix finish_reason "length".

Probier es aus, bevor du die Antwort öffnest:

Was die erste Anfrage kostet#

Sagen wir, die obige Anfrage verbraucht etwa 30 Input-Tokens und die Antwort braucht etwa 100 Output-Tokens (ein Beispiel, keine Messung; dein usage-Feld zeigt die echten Zahlen). Bei DeepSeek-V4-Flash sind das $0.00001 zum aktuellen Preis, und der Preis ist zu jeder Stunde gleich. Die Preise pro 1M Tokens stehen in der Live-Tabelle auf the pricing page.

Dieselbe Postman-Anfrage kann ein anderes Modell ausprobieren. Ersetze nur die Zeile model, zum Beispiel durch zai-org/GLM-5.3-Flash (390K Kontext, bis zu 8.192 Output-Tokens), und drücke erneut Send. Ein Guthaben deckt alle Modelle ab, also ändert sich sonst nichts: gleiche URL, gleicher Schlüssel.

Wenn es nicht funktioniert#

Postman zeigt den Statuscode neben der Antwort an. Diese sind die üblichen Verdächtigen:

Zwei Postman-spezifische Dinge lohnen eine Prüfung. Wenn du 401 bekommst oder die URL falsch aussieht, prüfe, ob base_url und api_key in der Umgebung definiert sind, die du ausgewählt hast. Und wenn der Schlüssel richtig aussieht, du aber trotzdem 401 bekommst, öffne den Tab Authorization erneut: Der Auth Type muss Bearer Token sein, nicht No Auth. Mehr zu diesen Codes: API 401 or 404 error. Nicht sicher, welche ID du verwenden sollst? List models with GET /v1/models gibt alle zurück.

Wenn du zufrieden bist, drücke Save, gib der Anfrage einen Namen und wähle eine Collection. Beim nächsten Mal bearbeitest du nur das Feld content oder die Zeile model, um Antworten zu vergleichen. Die vollständige API-Referenz steht in the CheapTokens docs.