Asünkroonimistaotlused

Samad järelduse lõpp-punktid toetavad sünkroonset ja asünkroonset täitmist. Lisa "async": true juurde POST /v1/messages või POST /v1/chat/completions sisse https://api.model-gate.com.

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

Värav naaseb 202 Accepted:

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

The request_id on avaliku päringu identifikaator. See tagastatakse ka X-Request-ID.

Tooge tulemus ainult paneeli API kaudu, kasutades profiili kontotaseme API KEY-d:

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

Järjekorras või töötlemise päring tagastab oma praeguse oleku. Täidetud taotlus tagastatakse response_status, response_headersja response. Ebaõnnestunud päring tagastab ka error objektiks. Tundmatud, välismaised ja aegunud päringu ID-d tagastatakse 404.

Järelduste tegemiseks kasutatav mudeli API võti ei saa asünkroonimistulemusi tuua. Kontotaseme API KEY ei saa mudeleid kutsuda.

Kui profiilis on konfigureeritud tagasihelistamise URL, edastatakse sinna ka valmis tulemus. Küsitlus paneeli API kaudu jääb kättesaadavaks isegi siis, kui tagasihelistamised on lubatud.

Hoiatus ladustamise kohta: päring ja vastus salvestatakse ajutiselt Model Gate'i andmebaasi. Asünkroonitud kirjed kustutatakse 24 tunni pärast. Ärge kasutage asünkroonimisrežiimi andmete jaoks, mida ei tohi ajutiselt salvestada.

Tagasihelistamise allkirjade kasutamine X-Model-Gate-Signature: t=<unix>,v1=<hmac_sha256>, allkirjastades täpse stringi <timestamp>.<raw_body> profiililt tagasihelistamissaladusega.

Tagasihelistamised

Lõpetatud asünkroonimise tulemused saab edastada profiilis konfigureeritud tagasihelistamise URL-ile. Vaata Tagasihelistamised allkirja kontrollimiseks, korduskatseteks, turvalisuse ja idempotentsuse juhiste jaoks.