Solicitações assíncronas

Os mesmos pontos finais de inferência suportam execução síncrona e assíncrona. Adicionar "async": true para POST /v1/messages ou POST /v1/chat/completions sobre https://api.model-gate.com.

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

O portal retorna 202 Accepted:

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

O request_id é o identificador da solicitação pública. Também é retornado em X-Request-ID.

Recupere o resultado somente por meio da API do painel usando a API KEY no nível da conta do perfil:

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

Uma solicitação enfileirada ou em processamento retorna seu status atual. Uma solicitação concluída retorna response_status, response_headers, e response. Uma solicitação com falha também retorna um error objeto. Todos os IDs de solicitação desconhecidos, estrangeiros e expirados retornam 404.

A chave da API do modelo usada para inferência não pode recuperar resultados assíncronos. A API KEY no nível da conta não pode chamar modelos.

Quando uma URL de retorno de chamada é configurada no perfil, o resultado concluído também é entregue lá. A pesquisa por meio da API do painel permanece disponível mesmo quando os retornos de chamada estão ativados.

Aviso de armazenamento: a solicitação e a resposta são armazenadas temporariamente no banco de dados Model Gate. Os registros assíncronos são excluídos após 24 horas. Não use o modo assíncrono para dados que não devem ser armazenados temporariamente.

Uso de assinaturas de retorno de chamada X-Model-Gate-Signature: t=<unix>,v1=<hmac_sha256>, assinando a string exata <timestamp>.<raw_body> com o segredo de retorno de chamada do perfil.

Retornos de chamada

Os resultados assíncronos concluídos podem ser entregues ao URL de retorno de chamada configurado no Perfil. Ver Retornos de chamada para verificação de assinatura, novas tentativas, segurança e orientação de idempotência.