Asynchrone verzoeken

Dezelfde gevolgtrekkingseindpunten ondersteunen synchrone en asynchrone uitvoering. Toevoegen "async": true naar POST /v1/messages of POST /v1/chat/completions op https://api.model-gate.com.

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

De poort keert terug 202 Accepted:

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

De request_id is de openbare verzoek-ID. Het wordt ook teruggestuurd X-Request-ID.

Haal het resultaat alleen op via de paneel-API met behulp van de API-SLEUTEL op accountniveau uit het profiel:

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

Een in de wachtrij geplaatst of verwerkt verzoek retourneert de huidige status. Er komt een voltooid verzoek terug response_status, response_headers, En response. Een mislukt verzoek retourneert ook een error voorwerp. Onbekende, buitenlandse en verlopen aanvraag-ID's komen allemaal terug 404.

De Model API-sleutel die voor inferentie wordt gebruikt, kan geen asynchrone resultaten ophalen. De API KEY op accountniveau kan geen modellen aanroepen.

Wanneer een callback-URL in het profiel is geconfigureerd, wordt het voltooide resultaat daar ook afgeleverd. Polling via de paneel-API blijft beschikbaar, zelfs als callbacks zijn ingeschakeld.

Opslagwaarschuwing: het verzoek en het antwoord worden tijdelijk opgeslagen in de Model Gate-database. Asynchrone records worden na 24 uur verwijderd. Gebruik de asynchrone modus niet voor gegevens die niet tijdelijk mogen worden opgeslagen.

Terugbelhandtekeningen gebruiken X-Model-Gate-Signature: t=<unix>,v1=<hmac_sha256>, waarbij de exacte tekenreeks wordt ondertekend <timestamp>.<raw_body> met het terugbelgeheim van het profiel.

Terugbelgesprekken

Voltooide asynchrone resultaten kunnen worden afgeleverd op de callback-URL die is geconfigureerd in Profiel. Zien Terugbelgesprekken voor handtekeningverificatie, nieuwe pogingen, beveiliging en richtlijnen voor idempotentie.