Aszinkron kérések

Ugyanazok a következtetési végpontok támogatják a szinkron és aszinkron végrehajtást. Hozzáadás "async": true hogy POST /v1/messages vagy POST /v1/chat/completions -on https://api.model-gate.com.

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

Az átjáró visszatér 202 Accepted:

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

A request_id a nyilvános kérés azonosítója. Be is adják X-Request-ID.

Az eredményt csak a panel API-n keresztül kérheti le, a profil fiókszintű API-kulcsával:

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

A sorba állított vagy feldolgozási kérelem visszaadja aktuális állapotát. A kitöltött kérés visszatér response_status, response_headers, és response. A sikertelen kérés szintén egy error objektum. Az ismeretlen, külföldi és lejárt kérésazonosítók mind visszaküldik 404.

A következtetéshez használt Model API kulcs nem tudja lekérni az aszinkron eredményeket. A fiókszintű API KEY nem hívhat modelleket.

Ha a profilban be van állítva egy visszahívási URL, az elkészült eredmény is oda érkezik. A panel API-n keresztüli lekérdezés akkor is elérhető marad, ha a visszahívások engedélyezve vannak.

Tárolási figyelmeztetés: a kérés és a válasz ideiglenesen a Model Gate adatbázisban tárolódik. Az aszinkron rekordok 24 óra elteltével törlődnek. Ne használja az aszinkron módot olyan adatokhoz, amelyeket nem szabad ideiglenesen tárolni.

Visszahívási aláírások használata X-Model-Gate-Signature: t=<unix>,v1=<hmac_sha256>, a pontos karakterlánc aláírásával <timestamp>.<raw_body> a profilból származó visszahívási titokkal.

Visszahívások

A befejezett aszinkron eredmények a Profilban konfigurált visszahívási URL-re küldhetők. Lásd Visszahívások Az aláírás-ellenőrzés, az újrapróbálkozás, a biztonság és az idempotencia útmutatása.