Partner API よくある質問

アカウント API キーとモデル API キーの違いは何ですか?

アカウントレベルの API キー (mg_partner_...) を通じてモデル API キーを管理します https://p-api.model-gate.com/api/v1/partner/* そして、非同期結果を取得します。 https://p-api.model-gate.com/api/v1/requests/{request_public_id}。

モデル API キー (mg_live_...）推論リクエストを認証します。 https://api.model-gate.com。

アカウント レベルの Partner API キーを推論エンドポイントに送信したり、クライアント側アプリケーションで公開したりしないでください。

どのカウンターが強制するのか spend_limit?

リセット可能なもの usage カウンタは制限を強制します。 POST /api/v1/partner/keys/{key_public_id}/reset-usage キーカウンターをクリアします。 total_spent 生涯会計であり、リセットされることはありません。

すべてのモデル API キーには個別のアカウント残高がありますか?

いいえ。すべての Model API キーは、所有する Model Gate アカウントの残高から消費されます。キーごとおよびグループの制限により、アカウント残高を子残高に分割することなく使用が制限されます。

モデル API キーがローテーションされるとどうなりますか?

古いシークレットはすぐに機能しなくなります。ローテーション応答には、新しい平文のシークレットが 1 回含まれます。 Model Gate では完全なシークレットが再度表示されないため、安全に保管してください。

コールバックはどのように構成されますか?

設定する callback_url そして回転します callback_secret Model Gate プロファイル内。非同期完了結果は、コールバック URL が存在する場合に送信されます。オプションの低キー制限、キー グループ制限、および低アカウント残高イベントは個別に有効にすることができます。それらのしきい値はプロファイル通知で設定されます。

コールバック配信は耐久性があり、推論処理とは独立しています。すべてのイベントには厩舎が含まれます event_id これは再試行しても変更されないため、コンシューマの重複排除に使用する必要があります。任意のHTTP 2xx 応答は成功です。配信には合計で最大 6 回の試行が必要で、5 秒、30 秒、2 分、10 分、1 時間後に再試行されます。各試行には全体で 15 秒のタイムアウトがあります。トランスポート エラー、タイムアウト、および 2xx 以外の応答は再試行され、6 回目の試行が失敗するとイベントにマークが付けられます。 failed それ以上の自動再試行はありません。見る コールバック イベント カタログ、正確な 10 進数のペイロード、署名、宛先のセキュリティ、配信の詳細。

非同期結果はどれくらいの期間取得できますか?

非同期結果は 24 時間利用可能です。 GET https://p-api.model-gate.com/api/v1/requests/{request_public_id}。有効期限が切れると、保存されたリクエストとレスポンスは削除され、エンドポイントは戻ります。 404。

パートナーの突然変異は安全な再試行をサポートしていますか?

はい。 Partner APIごと POST、 PATCH、 そして DELETE 必要 Idempotency-Key。タイムアウト後に同じキーを使用して同じ論理操作を再試行します。 7 日間、Model Gate はミューテーションを再度実行せずに元の結果を返します。別のリクエストでキーを再利用すると、次の結果が返されます。 409。

詳細なリクエスト履歴はどのくらいの期間利用可能ですか?

詳細なパートナーリクエスト履歴は次のとおりです API_REQUESTS_HOT_RETENTION_DAYS (デフォルトは 7 日)、応答メタデータのウィンドウをレポートします。長期的な財務調整には、カーソルでページ分割された口座残高トランザクションを使用します。