API-Guthaben

Zuletzt aktualisiert July 20, 2026

Die Such-API ist prepaid. Du hältst ein Guthaben an API-Credits in der Währung deines Kontos, und jede kostenpflichtige Anfrage bucht davon ab. Das ist das Modell im Anthropic-Stil: zahle, was du nutzt, aus einem im Voraus aufgeladenen Guthaben. Die Suche auf der Website ist durch deine Mitgliedschaft abgedeckt und berührt dieses Guthaben nie — Credits sind nur für die API.

Zwei Töpfe

Dein Guthaben ist die Summe zweier getrennter Töpfe:

Topf	Herkunft	Lebenszyklus
Inklusive	Das monatliche Kontingent von Suede Ultimate	Wird zurückgesetzt zu Beginn jeder Periode — Reste verfallen, nichts wird übertragen.
Gekauft	Guthaben, das du kaufst, eine automatische Aufladung oder ein Promo-Code	Bleibt erhalten — verfällt nicht und wird nicht zurückgesetzt.

Eine Anfrage verbraucht zuerst den Inklusive-Topf, dann den gekauften — ein Monatskontingent wird also immer vor bezahltem Guthaben genutzt. Eine Abbuchung drückt keinen Topf unter null; eine laufende Anfrage wird immer abgeschlossen, und das Guthaben stoppt bei null.

Das Monatskontingent (Suede Ultimate)

Suede Ultimate enthält pro Periode Guthaben im Wert von 1.000 API-Anfragen, abgelegt im Inklusive-Topf. In USD sind das 20,00 $ (1.000 × 0,02 $ pro Anfrage); in jeder Region wird der entsprechende Betrag in ihrer Währung gewährt. Das Kontingent wird bei Aktivierung der Mitgliedschaft gewährt und zu Beginn jeder Abrechnungsperiode erneut.

Suede Pro enthält kein Monatskontingent — Pro-Mitglieder nutzen die API rein nach Verbrauch und kaufen Guthaben bei Bedarf. Ein Tarifwechsel greift zur nächsten Verlängerung: deine erste Ultimate-Periode startet das Kontingent, deine erste Pro-Periode beendet es (übriges Inklusive-Guthaben verfällt mit seiner letzten Ultimate-Periode — wie immer).

Was eine Anfrage kostet

Jede kostenpflichtige Anfrage kostet einen festen Betrag in deiner Währung:

Währung	Pro Anfrage
USD	0,02 $
GBP	0,02 £
EUR	0,02 €
CAD / AUD	0,03 $
JPY	3 ¥
KRW	30 ₩

Guthaben prüfen

Im Browser — öffne Einstellungen → Abrechnung → API-Guthaben (oder direkt /account/credits): Gesamtsumme, beide Töpfe, wann der Inklusive-Topf zurückgesetzt wird und eine Schätzung, wie viele Anfragen das Guthaben noch deckt.
Über die API — rufe GET /v1/usage auf. Es liefert included_cents, purchased_cents, die Summe und eine geschätzte Anfragenzahl — und verbraucht nie Guthaben. Dasselbe Guthaben liegt jeder kostenpflichtigen Antwort in den Headern X-Credits-Balance und X-Credits-Requests-Remaining bei.

Wenn das Guthaben aufgebraucht ist

Bei null liefern die kostenpflichtigen Endpunkte 402 insufficient_credits. Die Lösung: Guthaben nachkaufen oder die automatische Aufladung aktivieren. Die Nutzung lesen geht auch bei null — GET /v1/usage ist nie guthabenpflichtig.