Async žiadosti

Rovnaké koncové body inferencie podporujú synchrónne a asynchrónne vykonávanie. Pridať "async": true do POST /v1/messages alebo POST /v1/chat/completions na https://api.model-gate.com.

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

Brána sa vracia 202 Accepted:

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

The request_id je verejný identifikátor žiadosti. Tiež sa vracia v X-Request-ID.

Získať výsledok iba cez panel API pomocou kľúča API na úrovni účtu z profilu:

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

Požiadavka zaradená do frontu alebo spracovávaná požiadavka vráti svoj aktuálny stav. Vráti sa dokončená žiadosť response_status, response_headersa response. Neúspešná požiadavka tiež vráti error objekt. Všetky neznáme, cudzie a expirované ID žiadostí sa vrátia 404.

Kľúč API modelu, ktorý sa používa na odvodenie, nemôže získať asynchrónne výsledky. API KEY na úrovni účtu nemôže volať modely.

Keď je v profile nakonfigurovaná adresa URL spätného volania, doručí sa tam aj dokončený výsledok. Volanie cez rozhranie API panela zostáva dostupné aj vtedy, keď sú povolené spätné volania.

Upozornenie na úložisko: požiadavka a odpoveď sú dočasne uložené v databáze Model Gate. Asynchrónne záznamy sa vymažú po 24 hodinách. Nepoužívajte asynchrónny režim pre údaje, ktoré nesmú byť dočasne uložené.

Použitie podpisov spätného volania X-Model-Gate-Signature: t=<unix>,v1=<hmac_sha256>, podpísaním presného reťazca <timestamp>.<raw_body> s tajným volaním z profilu.

Spätné volania

Dokončené výsledky asynchronizácie možno doručiť na adresu URL spätného volania nakonfigurovanú v profile. Pozri Spätné volania pre overenie podpisu, opakovanie, bezpečnosť a vedenie idempotencie.