Żądania asynchroniczne

Te same punkty końcowe wnioskowania obsługują wykonywanie synchroniczne i asynchroniczne. Dodać "async": true Do POST /v1/messages Lub POST /v1/chat/completions NA https://api.model-gate.com.

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

Brama powraca 202 Accepted:

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

The request_id jest publicznym identyfikatorem żądania. Jest również zwracany X-Request-ID.

Wynik pobierz tylko poprzez API panelu przy użyciu klucza API na poziomie konta z profilu:

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

Żądanie umieszczone w kolejce lub przetwarzane zwraca swój bieżący status. Wypełniony wniosek powraca response_status, response_headers, I response. Nieudane żądanie zwraca również komunikat error obiekt. Zwracane są nieznane, obce i wygasłe identyfikatory żądań 404.

Klucz API modelu używany do wnioskowania nie może pobrać wyników asynchronicznych. Klucz API na poziomie konta nie może wywoływać modeli.

Jeśli w profilu skonfigurowany jest adres URL wywołania zwrotnego, dostarczany jest tam również kompletny wynik. Odpytywanie za pośrednictwem interfejsu API panelu pozostaje dostępne nawet wtedy, gdy włączone są wywołania zwrotne.

Ostrzeżenie dotyczące przechowywania: żądanie i odpowiedź są tymczasowo przechowywane w bazie danych Model Gate. Rekordy asynchroniczne są usuwane po 24 godzinach. Nie używaj trybu asynchronicznego w przypadku danych, które nie mogą być przechowywane tymczasowo.

Używane są podpisy wywołań zwrotnych X-Model-Gate-Signature: t=<unix>,v1=<hmac_sha256>, podpisując dokładny ciąg <timestamp>.<raw_body> z sekretem wywołania zwrotnego z profilu.

Oddzwonienia

Ukończone wyniki asynchronizacji można dostarczyć na adres URL wywołania zwrotnego skonfigurowany w profilu. Widzieć Oddzwonienia w celu weryfikacji podpisu, ponownych prób, bezpieczeństwa i wskazówek dotyczących idempotencji.