Асинхронные запросы

Одни и те же конечные точки вывода поддерживают синхронное и асинхронное выполнение. Добавлять "async": true к POST /v1/messages или POST /v1/chat/completions на https://api.model-gate.com.

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

Шлюз возвращается 202 Accepted:

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

The request_id — это общедоступный идентификатор запроса. Он также возвращается в X-Request-ID.

Получите результат только через API панели, используя API KEY уровня аккаунта из профиля:

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

Поставленный в очередь или обрабатываемый запрос возвращает свое текущее состояние. Завершенный запрос возвращается response_status, response_headers, и response. Неудачный запрос также возвращает error объект. Все неизвестные, внешние и просроченные идентификаторы запросов возвращаются. 404.

Ключ API модели, используемый для вывода, не может получить асинхронные результаты. API-ключ уровня учетной записи не может вызывать модели.

Если в профиле настроен URL-адрес обратного вызова, туда также доставляется готовый результат. Опрос через API панели остается доступным, даже если включены обратные вызовы.

Предупреждение о хранении: запрос и ответ временно сохраняются в базе данных Model Gate. Асинхронные записи удаляются через 24 часа. Не используйте асинхронный режим для данных, которые не должны храниться временно.

Использование сигнатур обратного вызова X-Model-Gate-Signature: t=<unix>,v1=<hmac_sha256>, подписывая точную строку <timestamp>.<raw_body> с секретом обратного вызова из профиля.

Обратные вызовы

Завершенные асинхронные результаты могут быть доставлены по URL-адресу обратного вызова, настроенному в профиле. Видеть Обратные вызовы для проверки подписи, повторных попыток, безопасности и руководства по идемпотентности.