Асинхронни заявки

Същите крайни точки за извод поддържат синхронно и асинхронно изпълнение. Добавете "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 KEY на ниво акаунт не може да извиква модели.

Когато в профила е конфигуриран URL адрес за обратно извикване, завършеният резултат също се доставя там. Проучването през API на панела остава достъпно дори когато обратните извиквания са активирани.

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

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

Обратни повиквания

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