ClaudeCloudflare Developer Platform2026/04/02 0:00

AI Gateway - Automatically retry on upstream provider failures on AI Gateway

要点だけを先に読めるように短く再構成したセクションです。

元記事

Quick Digest

要約

要点だけを先に読めるように短く再構成したセクションです。

claudejamodel: claude-sonnet-4-20250514

AI Gateway - アップストリームプロバイダー障害時の自動リトライ機能

Key Points

  • AI Gatewayに自動リトライ機能が追加
  • 最大5回のリトライと3種類のバックオフ戦略
  • クライアント側の変更不要で利用可能

Summary

Cloudflare AI Gatewayにゲートウェイレベルでの自動リトライ機能が追加されました。アップストリームプロバイダーがエラーを返した際に、クライアント側の変更なしで設定されたリトライポリシーに基づいて自動的にリクエストを再試行します。

Key Points

  • リトライ設定の柔軟性: 最大5回までのリトライ回数、100ms〜5秒の遅延時間、3種類のバックオフ戦略(Constant、Linear、Exponential)を設定可能
  • デフォルト設定とオーバーライド: ゲートウェイ全体にデフォルト設定を適用し、リクエスト毎のヘッダーで個別にオーバーライド可能
  • クライアント制御不要: クライアント側でリトライロジックを実装できない場合に特に有効
  • 複雑なフェイルオーバー: 異なるプロバイダー間でのフェイルオーバーにはDynamic Routingを使用

Full Translation

翻訳

原文の流れを保ったまま読める翻訳セクションです。

claudejamodel: claude-sonnet-4-20250514

AI Gateway - AI Gatewayでアップストリームプロバイダーの障害時に自動リトライ

AI Gatewayでアップストリームプロバイダーの障害時に自動リトライ

公開日: 2026年4月2日

AI Gatewayがゲートウェイレベルでの自動リトライをサポートするようになりました。アップストリームプロバイダーがエラーを返した場合、クライアント側の変更を必要とせずに、設定したリトライポリシーに基づいてゲートウェイがリクエストを自動的にリトライします。

設定可能な項目

  • リトライ回数: 最大5回まで設定可能
  • リトライ間隔: 100msから5秒まで設定可能
  • バックオフ戦略: 以下から選択
    • Constant(一定間隔)
    • Linear(線形増加)
    • Exponential(指数的増加)

これらのデフォルト設定はゲートウェイを通るすべてのリクエストに適用され、リクエストごとのヘッダーでオーバーライドすることも可能です。

利用シーン

この機能は、リクエストを行うクライアントを制御できず、呼び出し側でリトライロジックを実装できない場合に特に有用です。

より複雑なフェイルオーバーシナリオ

異なるプロバイダー間でのフェイルオーバーなど、より複雑なシナリオについては、Dynamic Routingをご利用ください。

詳細については、ゲートウェイの管理を参照してください。