Asinkroni zahtjevi

Iste krajnje točke zaključivanja podržavaju sinkrono i asinkrono izvođenje. Dodati "async": true do POST /v1/messages ili POST /v1/chat/completions na https://api.model-gate.com.

{"model":"claude-sonnet-4.6","messages":[{"role":"user","content":"Analyze this document"}],"async":true}

Gateway se vraća 202 Accepted:

{
  "request_id":"01J...",
  "status":"queued",
  "result_url":"https://panel.model-gate.com/api/v1/requests/01J..."
}

The request_id je identifikator javnog zahtjeva. Također se vraća u X-Request-ID.

Dohvatite rezultat samo putem API-ja ploče koristeći API KEY na razini računa iz profila:

curl https://panel.model-gate.com/api/v1/requests/01J... 
  -H "Authorization: Bearer mg_partner_..."

Zahtjev koji je u redu čekanja ili zahtjev za obradu vraća svoj trenutni status. Vraća se završen zahtjev response_status, response_headers, i response. Neuspjeli zahtjev također vraća error objekt. Vraćaju se nepoznati, strani i istekli ID-ovi zahtjeva 404.

Model API ključ koji se koristi za zaključivanje ne može dohvatiti asinkrone rezultate. API KEY na razini računa ne može pozivati ​​modele.

Kada je URL za povratni poziv konfiguriran u profilu, tamo se isporučuje i dovršeni rezultat. Anketiranje putem API-ja panela ostaje dostupno čak i kada su povratni pozivi omogućeni.

Upozorenje o pohrani: zahtjev i odgovor su privremeno pohranjeni u bazi podataka Model Gate. Asinkroni zapisi brišu se nakon 24 sata. Nemojte koristiti asinkroni način za podatke koji se ne smiju privremeno pohranjivati.

Upotreba potpisa za povratni poziv X-Model-Gate-Signature: t=<unix>,v1=<hmac_sha256>, potpisujući točan niz <timestamp>.<raw_body> s tajnom povratnog poziva iz profila.

Povratni pozivi

Dovršeni asinkroni rezultati mogu se isporučiti na URL za povratni poziv konfiguriran u Profilu. Vidjeti Povratni pozivi za provjeru potpisa, ponovne pokušaje, sigurnost i upute za idempotenciju.