MGModel Gate
ConectareÎncepeți

Reapeluri

Primiți notificări semnate de la server la server și rezultate asincrone finalizate.

Reapeluri

Configurați o adresă URL de apel invers în Profil → Apeluri inverse și rezultate asincrone. Model Gate trimite HTTPS POST solicitări pentru notificări de cont activate și pentru solicitări de inferență asincrone finalizate.

Adresa URL de apel invers

Utilizați un punct final HTTPS accesibil public. Punctul final ar trebui să citească corpul cererii brute, să verifice semnătura, să proceseze evenimentul în mod idempotent și să returneze HTTP 200 de îndată ce evenimentul a fost acceptat.

Evenimente

Reapelurile pot include:

  • rezultatele inferenței asincrone finalizate;
  • notificări de sold scăzut al contului când sunt activate;
  • Notificări privind limita de cheltuieli cu cheia API atunci când este activată;
  • notificări privind limita de cheltuieli pentru grupul de chei atunci când sunt activate.

Livrarea rezultatelor asincrone este activată ori de câte ori este configurată o adresă URL de apel invers. Casetele de selectare de notificare din Profil controlează numai alertele de sold și limită corespunzătoare.

Format de solicitare

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

Exemplu de sarcină utilă a rezultatului asincron:

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

Câmpurile de sarcină utilă pot fi extinse în timp. Ignorați câmpurile necunoscute.

Verificarea semnăturii

Antetul semnăturii are acest format:

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

Calculați HMAC-SHA256 peste șirul exact <timestamp>.<raw_body> folosind secretul de apel invers afișat în Profil. Comparați semnătura hexazecimală cu o comparație în timp constant și respingeți marcajele de timp în afara ferestrei de redare acceptate.

Livrare și reîncercări

Returnează HTTP 200 după acceptarea în siguranță a evenimentului. Răspunsurile non-2xx și erorile de conexiune pot fi reîncercate. Prin urmare, punctul dvs. final trebuie să fie idempotent; utilizare request_id împreună cu event ca cheie de deduplicare.

Nu efectuați lucrări de lungă durată înainte de a răspunde. Pune evenimentul în coadă intern, întoarce-te 200și procesează-l în mod asincron.

Documentatia aferenta