Deine erste API-Anfrage mit CheapTokens

Diese Anleitung führt dich von einem neuen Konto zu einer funktionierenden Anfrage. Du brauchst eine E-Mail-Adresse, ein kleines Guthaben und ein Terminal. Die API ist OpenAI-kompatibel, wenn du also schon einmal OpenAI aufgerufen hast, ändern sich nur zwei Dinge: die Basis-URL und der Schlüssel.

Was du brauchst#

• Ein Konto. Die Anmeldung erfolgt per E-Mail — kein Passwort, wir senden dir einen Anmeldelink.
• Ein Guthaben. Es gibt kein Abonnement: Du lädst ein USD-Guthaben auf, und jede Anfrage wird pro Token zum festen Tarif des Modells abgerechnet.
• Einen API-Schlüssel aus deinem Dashboard.

Schritt 1. Konto erstellen und aufladen#

Öffne die Anmeldeseite, gib deine E-Mail-Adresse ein und folge dem Link aus der E-Mail. Drücke im Dashboard auf Aufladen und wähle die Zahlungsweise:

• Krypto — ab 5 $; es fällt eine Einzahlungsgebühr von 5 % an.
• Karte — über einen Partner, der seine eigene Gebühr berechnet.

Schritt 2. API-Schlüssel kopieren#

Sobald dein Guthaben über null liegt — nach einer Aufladung oder einem Empfehlungsbonus —, erstellt das Dashboard deinen API-Schlüssel und zeigt ihn einmal an. Kopiere ihn sofort und halte ihn aus deinem Code heraus, zum Beispiel in einer Umgebungsvariable:

export CHEAPTOKENS_API_KEY="paste-your-key-here"

Wenn der Schlüssel durchsickert, drücke auf Rotieren: Du bekommst einen neuen Schlüssel und der alte funktioniert nicht mehr.

Schritt 3. Modell auswählen#

Anfragen benötigen die vollständige Modell-ID — mit dem Präfix vor dem Schrägstrich, genau wie die API sie auflistet. Der Katalog zum Zeitpunkt des Schreibens (Oktober 2026):

Der Katalog kann sich ändern, daher ist die API selbst die Quelle der Wahrheit. Diese Anfrage benötigt keinen Schlüssel:

curl https://api.cheaptokens.dev/v1/models

Schritt 4. Anfrage senden#

curl#

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": "Say hello in three languages"}]
  }'

Eine erfolgreiche Antwort kommt im Standardformat der Chat Completions zurück. Ein verkürztes Beispiel — dein Text, deine IDs und Zahlen werden abweichen, und die Antwort kann zusätzliche Service-Felder enthalten:

{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Hello! Hola! Bonjour!" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 14, "completion_tokens": 9, "total_tokens": 23 }
}

• Der Text steht in choices[0].message.content.
• Die Token-Nutzung steht in usage: prompt_tokens — Eingabe, completion_tokens — Ausgabe. Für diese beiden Zahlen wird die Anfrage abgerechnet.

Python#

Installiere das offizielle SDK mit pip install openai und richte es auf unsere Basis-URL aus:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",
    api_key=os.environ["CHEAPTOKENS_API_KEY"],
)
resp = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V4-Flash-0731",
    messages=[{"role": "user", "content": "Say hello in three languages"}],
)
print(resp.choices[0].message.content)
print("tokens in/out:", resp.usage.prompt_tokens, resp.usage.completion_tokens)

JavaScript#

Installiere das SDK mit npm install openai:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.cheaptokens.dev/v1",
  apiKey: process.env.CHEAPTOKENS_API_KEY,
});
const resp = await client.chat.completions.create({
  model: "deepseek-ai/DeepSeek-V4-Flash-0731",
  messages: [{ role: "user", content: "Say hello in three languages" }],
});
console.log(resp.choices[0].message.content);

Clients im Anthropic-Stil#

Clients, die für die Anthropic Messages API gebaut wurden, verwenden die Root-Adresse ohne /v1 — https://api.cheaptokens.dev — und senden den Schlüssel im Header x-api-key. Die Anthropic SDKs fügen den Pfad und den Header selbst hinzu; du setzt nur die Basis-URL und den Schlüssel.

Wenn etwas schiefgeht#

• 401 Invalid API key — der Schlüssel ist falsch geschrieben oder wurde rotiert. Prüfe, ob du ihn vollständig eingefügt hast; das Dashboard zeigt einen Schlüssel nur einmal an, wenn er also verloren ist, drücke auf Rotieren, um einen neuen zu bekommen.
• 402 — das Guthaben ist aufgebraucht, oder die Anfrage ging ohne den Header Authorization raus.
• 400 Model "…" not found — verwende die vollständige Modell-ID aus /v1/models, einschließlich des Präfixes vor dem Schrägstrich.
• 404 — prüfe die Adresse: Clients im OpenAI-Stil benötigen /v1 am Ende der Basis-URL.

Weitere Fälle und Lösungen: Häufige Verbindungsfehler und wie man sie behebt.

Was es kostet#

Jede Anfrage wird für Eingabe- und Ausgabe-Token separat abgerechnet, zum Tarif des Modells pro Million Token. Aktuelle Preise — dieselben Daten wie auf der Preisseite:

Nächster Schritt: Verbinde einen Coding-Agenten, zum Beispiel Cline, oder lerne, abzuschätzen, was ein KI-Agent kosten wird.

Sie empfehlen CheapTokens anderen Entwicklern? Über das Empfehlungsprogramm erhalten Sie einen Anteil an deren Aufladungen.