非同期リクエスト

同じ推論エンドポイントは、同期実行と非同期実行をサポートします。追加 "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..."
}

の request_id パブリックリクエストの識別子です。にも返却されます X-Request-ID。

プロファイルのアカウントレベルの API KEY を使用して、パネル API 経由でのみ結果を取得します。

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

キューに入れられたリクエストまたは処理中のリクエストは、現在のステータスを返します。完了したリクエストが返されます response_status、 response_headers、 そして response。失敗したリクエストでも次のメッセージが返されます。 error 物体。不明、外部、期限切れのリクエスト ID はすべて返されます。 404。

推論に使用されるモデル API キーは非同期結果を取得できません。アカウントレベルの API KEY はモデルを呼び出すことができません。

コールバック URL がプロファイルに設定されている場合、完成した結果もそこに配信されます。コールバックが有効になっている場合でも、パネル API を介したポーリングは引き続き利用できます。

保管に関する警告: リクエストとレスポンスは Model Gate データベースに一時的に保存されます。非同期レコードは 24 時間後に削除されます。一時的に保存してはいけないデータには非同期モードを使用しないでください。

コールバック署名の使用 X-Model-Gate-Signature: t=<unix>,v1=<hmac_sha256>、正確な文字列に署名します <timestamp>.<raw_body> プロファイルからのコールバック シークレットを使用します。

コールバック

完了した非同期結果は、プロファイルで設定されたコールバック URL に配信できます。見る コールバック 署名検証、再試行、セキュリティ、冪等性に関するガイダンス用。