smartchat

Kosten und Limits

#Das Schutz-Limit

Es gibt ein Limit: 120 Anfragen pro Minute für jeden API-Schlüssel oder jede MCP-Verbindung. REST- und MCP-Aufrufe mit demselben Schlüssel oder derselben Verbindung zählen zusammen. Es schützt dich und uns vor einem Fehler, etwa einer Schleife, die die API endlos aufruft. Es ist keine Nutzungsgrenze. Ein Schlüssel kann sein eigenes Limit senken; er kann es nicht erhöhen.

Jede Antwort zeigt, wo du stehst:

HeaderBedeutung
X-RateLimit-LimitErlaubte Anfragen pro Minute für diesen Schlüssel.
X-RateLimit-RemainingÜbrige Anfragen in der laufenden Minute.
X-RateLimit-ResetWann die Minute endet (Unix-Zeit in Sekunden).
X-RateLimit-ClassDie Klasse des Aufrufs: read, write, send, bulk oder upload.

Gehst du darüber, lautet die Antwort 429 rate_limited mit dem Header Retry-After (Sekunden). Warte so lange und sende die Anfrage noch einmal. Du kannst die Anfrage ohne Gefahr wiederholen; es wurde nichts getan.

Das Python-Beispiel braucht das Paket requests (pip install requests).

import os
import time
import requests

def get_with_wait(url, headers):
    while True:
        response = requests.get(url, headers=headers)
        if response.status_code != 429:
            return response
        time.sleep(int(response.headers.get("Retry-After", "1")))

headers = {"Authorization": "Bearer " + os.environ["SMARTCHAT_API_KEY"]}
print(get_with_wait("https://api.smartchat.marketing/v1/me", headers).status_code)

SmartChat zählt Aufrufe in einem Audit-Log. Sieht die Menge der Aufrufe ungewöhnlich aus, wird das SmartChat-Team gewarnt. Es gibt kein anderes Limit dafür, wie viel du tun darfst.

#Das Tageslimit der WhatsApp-Nummer

Das ist kein Limit deines Schlüssels. WhatsApp begrenzt, wie vielen neuen Personen eine Telefonnummer pro Tag schreiben darf. Eine Newsletter-Vorschau zeigt es: daily_limit ist diese Zahl (oder null, wenn es keine gibt) und estimated_days ist die Zahl der Tage, die der Versand deshalb dauert. Eine größere Zielgruppe wird über mehrere Tage gesendet; nichts geht verloren. Siehe get_newsletter_send_preview.

#Credits

Aufrufe der API brauchen keine Credits. Dasselbe in der App mit einer AI-Funktion zu tun, kann Credits brauchen. Eine Referenzseite sagt "Verbraucht Credits", wenn ein Aufruf eine Ausnahme ist. Das Senden von Nachrichten folgt dem Kontingent deines Tarifs; ist es aufgebraucht, lautet die Antwort quota_exceeded.