Beheben Sie Abrechnungsfehler und legen Sie Kundenausgabelimits fest

Verwenden Sie "Log-in with ShareAI" für die Identität und "Pay with ShareAI" für explizite, kontofinanzierte Aktionen. Der openid Umfang allein autorisiert keine Ausgaben. KI-Inferenz erfordert inference eine genehmigte, zugestimmte surcharge Berechtigung; payments Anfragen separat bestätigte Checkouts. Der Kunde steuert ein monatliches KI-Limit in der Konsole. Ihre Anwendung kann es nicht ändern.

Fehler nach Code behandeln#

HTTP 402 · insufficient_credits: Das Zahlungskonto hat nicht genügend unverfallene Guthaben, die für diesen Anbieter/dieses Modell und diese Anfrage geeignet sind. Bitten Sie den Kunden, seine Guthaben zu verwalten. Einige Guthaben haben Anbieter- oder Modellbeschränkungen.

HTTP 402 · application_spending_limit_exceeded: Das monatliche Limit ist erreicht, reservierte Anfragen nutzen die verfügbare Zuweisung, oder die Kosten dieser Anfrage würden es überschreiten. Behandeln Sie dies nicht als Ratenlimit und versuchen Sie nicht automatisch erneut. Bitten Sie den Kunden, das Limit zu ändern oder zu warten, bis reset_at.

HTTP 429 · oauth_rate_limit: ein temporäres Anfragen-/Konkurrenzlimit. Folgen Sie Retry-After und begrenztem Backoff. HTTP 401 · consent_required: Die Zustimmung ist abgelaufen, widerrufen oder nicht mehr gültig; holen Sie eine neue Autorisierung ein, anstatt eine Aufladung anzufordern.

{
  "error": {
    "type": "billing_error",
    "code": "application_spending_limit_exceeded",
    "message": "This application's monthly AI spending limit has been reached or this request would exceed it. Manage the limit or wait for the next month.",
    "management_url": "https://console.shareai.now/?shareai_billing_context=OPAQUE_SHORT_LIVED_VALUE",
    "help": "https://console.shareai.now/?shareai_billing_context=OPAQUE_SHORT_LIVED_VALUE",
    "monthly_limit": "50",
    "reset_at": "2026-10-01T00:00:00Z"
  }
}

Die beiden finanziellen Fehler verwenden error.type = billing_error. management_url ist das Ziel für die Kundenwiederherstellung; help ist sein Kompatibilitätsalias. monthly_limit ist eine genaue EUR-Dezimalzeichenfolge und reset_at ist UTC. Sie sind bei Limitfehlern vorhanden und können bei Fehlern aufgrund unzureichender Guthaben fehlen.

Das richtige Zahlungskonto öffnen#

Bieten Sie eine sichtbare Abrechnung verwalten Aktion mit der zurückgegebenen URL an. Der undurchsichtige Kontext läuft nach 15 Minuten ab, identifiziert das ursprüngliche Zahlungskonto und die Verbindung und bleibt nach der Weiterleitung beim Anmelden erhalten. Die Konsole überprüft die Besitzer-/Admin-Berechtigungen des angemeldeten Besuchers, bevor sie dieses Konto auswählt. Ersetzen Sie es nicht durch die Abrechnungsseite des Anwendungsbesitzers, erfinden Sie keine Akteurs-ID, fügen Sie kein Zugriffstoken hinzu oder leiten Sie den Kunden nicht automatisch weiter.

Verwenden Sie eine Positivliste für den Ursprung der Konsole und rel="noopener noreferrer" beim Öffnen eines neuen Tabs. Der Link ist eine Navigation, keine Autorisierung oder ein Nachweis, dass Gelder hinzugefügt wurden. Speichern Sie ihn nicht als permanentes Lesezeichen oder in öffentlichen Protokollen. Nach Ablauf kann der Kunde die Abrechnung direkt öffnen. Eine neue Anfrage kann einen neuen Link zurückgeben, nachdem der Kunde ausdrücklich um einen erneuten Versuch gebeten hat.

const response = await fetch("https://api.shareai.now/api/v1/chat/completions", options);
const body = await response.json();
const error = body.error;
if (response.status === 402 && error?.type === "billing_error") {
  const message = error.code === "application_spending_limit_exceeded"
    ? "Your monthly limit for this app has been reached."
    : "Your ShareAI account needs eligible credits.";
  showBillingMessage(message);
  if (error.management_url) {
    const target = new URL(error.management_url);
    if (target.origin === "https://console.shareai.now") {
      // Render a user-activated link; never silently open it or retry spending.
      showManageBillingLink(target.href);
    }
  }
  return;
}
if (!response.ok || error) throw new Error(error?.message || "Request failed");
renderAnswer(body);

Streaming und endgültige Abrechnung#

ShareAI überprüft das Limit vor der Zulassung/Bindung und prüft die tatsächlichen Netzwerkkosten plus Aufschlag atomar bei der Abrechnung. Gleichzeitige Anfragen teilen sich dasselbe Limit. Eingabeschätzungen reservieren Spielraum; die Ausgabelänge ist im Voraus nicht bekannt. Eine endgültige Belastung, die die verbleibende Zuweisung überschreiten würde, wird ohne Nutzungsabbuchung oder Builder-Aufschlagsgutschrift abgelehnt.

Für Chat Completions SSE behandeln Sie event: error mit denselben error.code und Wiederherstellungsfeldern. Für Responses SSE behandeln Sie response.failed und lesen Sie response.error. Sobald der Stream startet, hat sein HTTP-Status bereits 200; Teilinhalte bedeuten keinen erfolgreichen Abschluss. Markieren Sie das Ergebnis nicht als abgeschlossen, führen Sie keine nachgelagerten kostenpflichtigen Aktionen durch und senden Sie nicht automatisch erneut nach einem endgültigen Fehler. Nicht-Streaming-Chat, Responses, Embeddings und Images zeigen den Abrechnungsfehler als HTTP 402 Root error Hülle an.

Umfang und Rücksetzungen#

Der Kalendermonat läuft in UTC. Das Limit gilt pro zahlendem Konto und Anwendung, geteilt über OAuth-Clients, Berechtigungen und aktualisierte Tokens; ein Client-Service verwendet seine stabile Arbeits-ID auch bei Schlüsselrotationen in der Produktionsumgebung. Nur die abgerechneten Kosten des AI-Netzwerks plus Aufschlag werden berücksichtigt. Feste Abonnements und separat bestätigte Käufe haben ihre eigene Checkout-Autorisierung und verbrauchen dieses AI-Limit nicht. Null pausiert zusätzliche AI-Ausgaben; null bedeutet kein Limit. Vergangene Gebühren bleiben erhalten, wenn das Limit bearbeitet oder die Verbindung erneut autorisiert wird.

Dies sind Kundenkontrollen in der Konsole, kein Entwickler-Endpunkt zur Erhöhung von Budgets. Setzen Sie weiterhin die Berechtigungsbereiche des Grants, genehmigte Modelle, Kundenanbieterpräferenzen und akzeptierte Aufschlagsbedingungen durch. Kundenabrechnungsleitfaden · Checkout-API.