Asinhrone zahteve

Iste končne točke sklepanja podpirajo sinhrono in asinhrono izvajanje. Dodaj "async": true do POST /v1/messages oz POST /v1/chat/completions na https://api.model-gate.com.

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

Prehod se vrne 202 Accepted:

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

The request_id je javni identifikator zahteve. Prav tako se vrača v X-Request-ID.

Pridobite rezultat samo prek API-ja plošče z uporabo KLJUČA API-ja na ravni računa iz profila:

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

Zahteva v čakalni vrsti ali obdelava vrne trenutni status. Izpolnjena zahteva se vrne response_status, response_headers, in response. Neuspela zahteva prav tako vrne error predmet. Vrnejo se neznani, tuji in potečeni ID-ji zahtev 404.

Ključ API modela, uporabljen za sklepanje, ne more pridobiti asinhronih rezultatov. The account-level API KEY cannot call models.

Ko je URL za povratni klic konfiguriran v profilu, se tja dostavi tudi končan rezultat. Anketiranje prek API-ja plošče ostane na voljo, tudi če so omogočeni povratni klici.

Opozorilo glede shranjevanja: zahteva in odgovor sta začasno shranjena v bazi podatkov Model Gate. Asinhroni zapisi se izbrišejo po 24 urah. Ne uporabljajte asinhronega načina za podatke, ki jih ni dovoljeno začasno shranjevati.

Uporaba podpisov za povratni klic X-Model-Gate-Signature: t=<unix>,v1=<hmac_sha256>, s podpisom natančnega niza <timestamp>.<raw_body> s skrivnostjo povratnega klica iz profila.

Povratni klici

Dokončane asinhrone rezultate je mogoče dostaviti na URL za povratni klic, konfiguriran v profilu. Glej Povratni klici za preverjanje podpisa, ponovne poskuse, varnost in navodila za idempotenco.