MGModel Gate
anmeldenFangen Sie an

Rückrufe

Erhalten Sie signierte Server-zu-Server-Benachrichtigungen und abgeschlossene asynchrone Ergebnisse.

Rückrufe

Konfigurieren Sie eine Rückruf-URL in Profil → Rückrufe und asynchrone Ergebnisse. Model Gate sendet HTTPS POST Anfragen für aktivierte Kontobenachrichtigungen und für abgeschlossene asynchrone Inferenzanfragen.

Rückruf-URL

Verwenden Sie einen öffentlich erreichbaren HTTPS-Endpunkt. Der Endpunkt sollte den rohen Anforderungstext lesen, die Signatur überprüfen, das Ereignis idempotent verarbeiten und HTTP zurückgeben 200 sobald die Veranstaltung angenommen wurde.

Veranstaltungen

Rückrufe können Folgendes umfassen:

  • abgeschlossene Ergebnisse der asynchronen Inferenz;
  • Benachrichtigungen bei niedrigem Kontostand, wenn aktiviert;
  • API-Schlüssel-Ausgabelimitbenachrichtigungen, wenn aktiviert;
  • Benachrichtigungen über Ausgabenlimits für Schlüsselgruppen, sofern aktiviert.

Die asynchrone Ergebnisübermittlung ist immer dann aktiviert, wenn eine Rückruf-URL konfiguriert ist. Die Benachrichtigungs-Kontrollkästchen im Profil steuern nur die entsprechenden Saldo- und Limit-Benachrichtigungen.

Anfrageformat

POST /model-gate/callback HTTP/1.1
Content-Type: application/json
X-Model-Gate-Signature: t=1710000000,v1=hex_hmac_sha256

Beispiel für die Nutzlast eines asynchronen Ergebnisses:

{
  "event":"async.completed",
  "request_id":"01J...",
  "status":"completed",
  "response":{"id":"msg_...","type":"message"}
}

Nutzlastfelder können im Laufe der Zeit erweitert werden. Unbekannte Felder ignorieren.

Signaturüberprüfung

Der Signaturheader hat dieses Format:

X-Model-Gate-Signature: t=<unix>,v1=<hmac_sha256>

Berechnen Sie HMAC-SHA256 über die genaue Zeichenfolge <timestamp>.<raw_body> Verwenden des im Profil angezeigten Rückrufgeheimnisses. Vergleichen Sie die hexadezimale Signatur mit einem konstanten Zeitvergleich und lehnen Sie Zeitstempel außerhalb Ihres akzeptierten Wiedergabefensters ab.

Zustellung und Wiederholungsversuche

HTTP zurückgeben 200 nach sicherer Annahme der Veranstaltung. Nicht-2xx-Antworten und Verbindungsfehler können wiederholt werden. Ihr Endpunkt muss daher idempotent sein; verwenden request_id zusammen mit event als Deduplizierungsschlüssel.

Führen Sie keine langwierigen Arbeiten aus, bevor Sie antworten. Stellen Sie das Ereignis intern in die Warteschlange und kehren Sie zurück 200und asynchron verarbeiten.

Zugehörige Dokumentation