Partner API FAQ

Was ist der Unterschied zwischen einem Konto-API-Schlüssel und einem Modell-API-Schlüssel?

Der API-Schlüssel auf Kontoebene (mg_partner_...) verwaltet Modell-API-Schlüssel durch https://p-api.model-gate.com/api/v1/partner/* und ruft asynchrone Ergebnisse ab https://p-api.model-gate.com/api/v1/requests/{request_public_id}.

Ein Modell-API-Schlüssel (mg_live_...) authentifiziert Inferenzanfragen durch https://api.model-gate.com.

Senden Sie niemals einen Partner API-Schlüssel auf Kontoebene an einen Inferenzendpunkt und machen Sie ihn niemals in clientseitigen Anwendungen verfügbar.

Welcher Zähler erzwingt spend_limit?

Die rücksetzbare usage Der Zähler erzwingt das Limit. POST /api/v1/partner/keys/{key_public_id}/reset-usage löscht den Schlüsselzähler. total_spent ist lebenslange Abrechnung und wird nie zurückgesetzt.

Verfügt jeder Modell-API-Schlüssel über einen separaten Kontostand?

Nein. Alle Model-API-Schlüssel werden vom Guthaben des besitzenden Model Gate-Kontos abgebucht. Schlüssel- und Gruppenlimits schränken die Nutzung ein, ohne den Kontostand in untergeordnete Guthaben aufzuteilen.

Was passiert, wenn ein Modell-API-Schlüssel rotiert wird?

Das alte Geheimnis funktioniert sofort nicht mehr. Die Rotationsantwort enthält einmalig das neue Klartextgeheimnis. Bewahren Sie es sicher auf, da Model Gate das vollständige Geheimnis nicht erneut anzeigt.

Wie werden Rückrufe konfiguriert?

Konfigurieren callback_url und drehen callback_secret im Model Gate-Profil. Ergebnisse der asynchronen Vervollständigung werden gesendet, wenn eine Rückruf-URL vorhanden ist. Optionale Low-Key-Limit-, Key Group-Limit- und Low-Account-Balance-Ereignisse können separat aktiviert werden; Ihre Schwellenwerte werden in Profilbenachrichtigungen konfiguriert.

Die Rückrufzustellung ist dauerhaft und unabhängig von der Inferenzverarbeitung. Zu jeder Veranstaltung gehört ein Stall event_id Dieser bleibt bei Wiederholungsversuchen unverändert und muss für die Verbraucherdeduplizierung verwendet werden. Beliebiges HTTP 2xx Antwort ist erfolgreich. Für die Zustellung werden insgesamt höchstens 6 Versuche benötigt, mit Wiederholungsversuchen nach 5 Sekunden, 30 Sekunden, 2 Minuten, 10 Minuten und 1 Stunde; Jeder Versuch hat eine Gesamtzeitüberschreitung von 15 Sekunden. Transportfehler, Zeitüberschreitungen und Nicht-2xx-Antworten werden erneut versucht, und nach dem sechsten fehlgeschlagenen Versuch wird das Ereignis markiert failed ohne weiteren automatischen Wiederholungsversuch. Sehen Rückrufe für den Veranstaltungskatalog, genau dezimale Nutzlasten, Signaturen, Zielsicherheit und Lieferdetails.

Wie lange kann ein asynchrones Ergebnis abgerufen werden?

Ein asynchrones Ergebnis bleibt 24 Stunden lang verfügbar GET https://p-api.model-gate.com/api/v1/requests/{request_public_id}. Nach Ablauf werden die gespeicherte Anfrage und Antwort gelöscht und der Endpunkt kehrt zurück 404.

Unterstützen Partnermutationen eine sichere Wiederholung?

Ja. Alle Partner API POST, PATCH, Und DELETE erfordert Idempotency-Key. Wiederholen Sie nach einer Zeitüberschreitung dieselbe logische Operation mit demselben Schlüssel. 7 Tage lang gibt Model Gate das ursprüngliche Ergebnis zurück, ohne die Mutation erneut auszuführen. Die Wiederverwendung eines Schlüssels für eine andere Anfrage führt zu Rückgaben 409.

Wie lange ist der detaillierte Anfrageverlauf verfügbar?

Der detaillierte Verlauf der Partneranfragen folgt API_REQUESTS_HOT_RETENTION_DAYS (Standard 7 Tage) und meldet dieses Fenster in den Antwortmetadaten. Verwenden Sie Cursor-Paginierungskontostandstransaktionen für einen längerfristigen Finanzabgleich.