Asynchronní požadavky

Stejné koncové body odvození podporují synchronní a asynchronní provádění. Přidat "async": true na POST /v1/messages nebo 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 se vrací 202 Accepted:

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

The request_id je veřejný identifikátor požadavku. Je také vrácen v X-Request-ID.

Načtěte výsledek pouze prostřednictvím rozhraní API panelu pomocí KLÍČE API na úrovni účtu z profilu:

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

Požadavek zařazený do fronty nebo zpracovávaný požadavek vrátí svůj aktuální stav. Dokončený požadavek se vrátí response_status, response_headersa response. Neúspěšný požadavek také vrátí error objekt. Všechna neznámá, cizí a prošlá ID žádostí se vrátí 404.

Klíč API modelu použitý pro odvození nemůže načíst asynchronní výsledky. KLÍČ API na úrovni účtu nemůže volat modely.

Když je v profilu nakonfigurována adresa URL zpětného volání, je tam také doručen dokončený výsledek. Dotazování prostřednictvím rozhraní API panelu zůstává dostupné, i když jsou povolena zpětná volání.

Upozornění na úložiště: požadavek a odpověď jsou dočasně uloženy v databázi Model Gate. Asynchronní záznamy se vymažou po 24 hodinách. Nepoužívejte asynchronní režim pro data, která nesmějí být dočasně uložena.

Použití podpisů zpětného volání X-Model-Gate-Signature: t=<unix>,v1=<hmac_sha256>, podepsat přesný řetězec <timestamp>.<raw_body> s tajným zpětným voláním z profilu.

Zpětná volání

Dokončené asynchronní výsledky lze doručit na adresu URL pro zpětné volání nakonfigurovanou v profilu. Vidět Zpětná volání pro ověření podpisu, opakování, zabezpečení a vedení idempotence.