Sol·licituds asíncrones

Els mateixos punts finals d'inferència admeten l'execució síncrona i asíncrona. Afegeix "async": true a POST /v1/messages o POST /v1/chat/completions activat https://api.model-gate.com.

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

La porta d'entrada torna 202 Accepted:

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

El request_id és l'identificador de la sol·licitud pública. També es torna a dins X-Request-ID.

Recupereu el resultat només a través de l'API del panell utilitzant la CLAU d'API a nivell de compte del perfil:

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

Una sol·licitud en cua o en procés retorna el seu estat actual. Torna una sol·licitud completada response_status, response_headers, i response. Una sol·licitud fallida també retorna un error objecte. Tornen tots els identificadors de sol·licitud desconeguts, estrangers i caducats 404.

La clau de l'API del model utilitzada per a la inferència no pot recuperar resultats asíncrons. La CLAU d'API del nivell de compte no pot cridar models.

Quan es configura un URL de retorn de trucada al perfil, també s'hi lliura el resultat completat. L'enquesta a través de l'API del panell continua disponible fins i tot quan les devolucions de trucada estan habilitades.

Avís d'emmagatzematge: la sol·licitud i la resposta s'emmagatzemen temporalment a la base de dades Model Gate. Els registres asíncrons se suprimeixen després de 24 hores. No utilitzeu el mode asíncron per a dades que no s'han d'emmagatzemar temporalment.

Utilització de signatures de devolució de trucada X-Model-Gate-Signature: t=<unix>,v1=<hmac_sha256>, signant la cadena exacta <timestamp>.<raw_body> amb el secret de devolució de trucada del perfil.

Devolució de trucades

Els resultats aixíncrons completats es poden lliurar a l'URL de devolució de trucada configurat al perfil. Vegeu Devolució de trucades per a la verificació de la signatura, els reintents, la seguretat i la guia d'idempotència.