症状の捉え方:OpenRouter だけがタイムアウトや 429 に見える理由

OpenRouter は複数プロバイダへ橋渡しする統合 LLM APIとして人気が高く、開発者の検索意図も「単一モデル」より「入口は一つだが背後でホストが分岐する」ことに寄りがちです。ブラウザで一般サイトは速いのに、OpenRouter のコンソールやアプリからの呼び出しだけが遅い、あるいはダッシュボードは開けるのに /api/v1 系のリクエストだけが失敗する、といった非対称な詰まりは珍しくありません。

ここで陥りやすいのは「遅いのはプロキシノード一本のせいだ」と決め打ちして終わることです。実際には、短い HTML やアイコン類の取得、長い JSON のストリーミング、認証まわりの往復が別ホストや別経路になりやすく、同じブランド名でもパケットの性質は揃いません。とくに API タイムアウトは接続確立の遅さ・中間装置のドロップ・DNS の食い違いなど複合要因になり得ます。一方 429 は HTTP として明示的なレート制限のシグナルであり、原因の切り分けはタイムアウトとは別ラインで考えたほうが早いです。

本稿は単一ベンダ向けのChatGPT/OpenAI 分流や、ターミナル中心のCodex CLI 向け稿と肩を並べつつ、OpenRouter 特有の「統合入口と静的取得の同居」を軸にします。動画 CDN を扱ったSora 向け記事と同じく、メディアと API の力学差を意識すると説明がしやすいテーマです。

API と CDN/静的ホストを分ける意味

多くの購読プロファイルは、国内向けの太い例外、GEOIP、safelist などを上から評価します。OpenRouter 関連だけを広く PROXY に押し込むと、(1) 静的アセット取得が細かく並列になり一部だけ別ルールへ滑る、(2) 長めの API が単一出力帯で頭打ちになりタイムアウトに見える、(3) 逆に広い例外のせいで意図せず直結側に落ちている、のいずれかが混ざりやすくなります。

実務では OR_API と OR_STATIC のような論理ポリシーを二つ用意し、ログで増えた FQDN をバケツ分けするのが扱いやすいです。名前は任意ですが、「長い推論やストリームをさばきたい出口」と「ドキュメントやバンドル、画像・フォント類を素早く取りたい出口」を心理的に分離しておくと、チーム内のチケット記述や AB 試験も速くなります。共通の語彙は分流ルール入門で押さえておくと、この後の順序調整とも矛盾しにくくなります。

HTTP 429 とタイムアウト:混同しない切り分け

429 が返っているなら、まずレスポンス本文やヘッダにリトライ可能秒数が載っていないかを確認してください。サービス側のクォータ・レートウィンドウに引っかかっている場合は、Clash 分流をいじっても根本原因は変わりません。逆にタイムアウトばかりでステータスすら読めない場合は、経路や MTU・UDP/QUIC、ノード側のキュー溢れなどネットワーク寄りの仮説が前面に立ちます。

ただし「クライアントが途中で諦めたタイムアウト」を、ダッシュボード上では 429 や 5xx のように誤認するケースもあるため、アプリ側ログとコアログを突き合わせるのが安全です。OpenRouter の公式ドキュメントでは API ベースが https://openrouter.ai 配下にまとまっている例が多いですが、フロントが別サブドメインやサードパーティ CDN を引くかどうかは時期により変わり得ます。ここは暗記より観測が正です。

ホストの観測:ログ駆動で CDN ドメインを拾う

まず失敗の再現手順を短く固定し、同じ操作をもう一度行いながらコアログを開いてください。TLS SNI や HTTP Host に現れる名前をそのままメモし、openrouter.ai 以外に増えたドメインがないかを見ます。静的バンドルやサードパーティ計測ホストまで全部を OpenRouter のテーマに混ぜる必要はありませんが、「API の往復だけ遅い」と言い切れるかどうかはこの列挙で決まります。

DOMAIN-KEYWORD は誤爆しやすいので、長期的にはFQDN ベースへ寄せるのが無難です。rule-providers で購読しているリストが同じゾーンをどう扱っているかも確認し、自分の細かいルールと競合していないかを見てください。接続はあるのに表示がおかしい類の切り分けはDNS とログの記事とも相性がよいです。

ポリシーグループの組み方:低遅延と帯域を分ける

実際のプロキシ候補は環境差が大きいため、ここでは「どの種類のトラフィックをどのバケツに入れるか」という設計図だけ示します。API 向けはレイテンシと安定性を優先し、静的向けは帯域とキャッシュフレンドリーな出口を優先する、といった住み分けが典型です。どちらも同じ実サーバ名を使う select でも構いませんが、運用で迷子にならないよう意味のあるグループ名を付けてください。

ファイナライズ前に、片方だけ別ノードへ載せ替えたとき症状がどう変わるかを短時間比較すると、ボトルネックが API 側か静的側かの当たりが付きます。結果が変わらないなら DNS やルール順、あるいはアプリがプロキシを踏んでいない線を先に疑ったほうが早い場合もあります。

示例 YAML:構造理解用(そのままコピペしない)

以下は概念図であり、環境ごとに検証されたホストへ置き換えてください。YAML 内のコメントは英語で記載します。

# Illustrative only — replace hostnames with those observed in your logs
proxy-groups:
  - name: OR_API
    type: select
    proxies:
      - LOW_LATENCY_NODE
      - RELIABLE_NODE

  - name: OR_STATIC
    type: select
    proxies:
      - HIGH_BW_NODE
      - LOW_LATENCY_NODE

rules:
  # Put concrete FQDNs from logs above broad catches
  - DOMAIN-SUFFIX,openrouter.ai,OR_API
  # If logs show separate CDN hosts, list them explicitly:
  # - DOMAIN-SUFFIX,cdn.example.com,OR_STATIC

  # Keep provider-specific OpenRouter rules above GEOIP / DIRECT broad rules

実際の OpenRouter 利用では、ダッシュボードと API が同一 apex を共有しつつも、パスやモジュール読み込みで追加ホストが現れることがあります。サフィックスルールが広すぎると他サービスまで同じ出口に吸い込まれる副作用もあるため、徐々に狭めるのが安全です。

DNS・fake-ip・ルール順の三重チェック

DNS が fake-ip 系のとき、ブラウザ独自 DoH や古いキャッシュと合成されると、「ルール上はこのポリシーだが実際の接続だけズレる」症状が起きます。OpenRouter の UI は初期描画後に多数の名前解決と並列フェッチを行いがちなので、一部だけ不一致だとAPI タイムアウトだけが目立つことがあります。

ルール順については GEOIP,CN,DIRECT や社内向けサフィックスが先に勝っていると、意図しない直結や逆方向の迂回が発生します。観測済みホスト向けの細かい行を、粗い例外より上に移したあと、ログで最初にマッチした行を必ず確認してください。変更の効き目は体感よりログのほうが正直です。

QUIC/HTTP3 が絡む静的取得で途切れる話題は、OpenRouter 固有というよりブラウザ一般の論点です。必要に応じて一時的に HTTP/3 を切って比較するのも有効で、近い切り口はQUIC 関連の記事にもまとめています。

アプリ設定:プロキシを踏まない SDK/CLI

Python や Node の SDK、社内ラッパーが HTTPS_PROXY を無視していると、ターミナルからだけ失敗が再現するパターンがあります。TUN モードを使うか、アプリがシステムプロキシを尊重するよう整えてから、改めて分流の効果を測ってください。ここが抜けていると「ルールをいくら足しても変わらない」まま時間を溶かしがちです。

チーム開発では、CI コンテナとローカル端末で出口が異なるだけでレートウィンドウの当たり方が変わることもあります。429 が常に特定アカウントだけに出るなら、経路よりクォータ調整やバックオフ実装を先に検討する価値があります。

規約・課金・地域制限について

利用規約、モデル提供者ごとのポリシー、課金とクォータ、地域制限は、ローカルプロキシの設定だけでは回避できません。本稿は正当な権限のあるネットワークで到達性と安定性を調べるための技術整理であり、サービス側制限の迂回を助長する意図はありません。

よくある質問

429 は分流を直せば必ず消えますか?

消えるとは限りません。429 はレート制限やクォータのシグナルであることが多く、出口を変えても同じならアカウント側の制御を疑ってください。一方、タイムアウトと混同しているだけなら、経路改善で見え方が変わるためログで HTTP ステータスを確定させます。

OpenRouter のホストは固定リストで管理してよいですか?

フロントの更新でCDN ドメインが増減し得るため、暗記リストよりログに現れた FQDNを優先してください。テンプレートはあくまで骨格です。

SDK や CLI がプロキシを踏まず失敗します

環境変数・TUN・コンテナネットワークのいずれかで、Clash の外に抜けている可能性があります。まずトラフィックがコアに到達しているかを確認し、その後に OR_API などの割当を試します。

まとめ・競合との比較とダウンロード

OpenRouter のような統合 API では、見た目は単一ブランドでも背後の取得パターンは多層になりやすく、API タイムアウトと 429 を分けて観測したうえで、CDN ドメインと API ホストを論理的に分けると切り分けが速くなります。暗記したドメインよりログの事実を優先し、DNS・ルール順・プロキシ非対応アプリの有無を同時に見ると、検索ユーザーの意図どおり「出口を分けて再現を潰す」運用に落とし込めます。

一方で、サイト単位の細かな分流やルール編集が苦手な汎用 VPN クラスの製品では、症状を単一トンネルに集約しがちで、どのホストが詰まっているか説明しづらいままになりがちです。設定画面が簡素なぶん、API と静的取得を別ポリシーへ載せ替える余地が狭く、長時間ストリームと短いバーストが混ざる開発者ワークフローには窮屈に感じる場面もあります。

Clash/Mihomo 系はポリシーグループとルール言語によりホスト単位の試行錯誤が軽く、ログとセットにするとリスト更新への追従もしやすいです。クライアント入手元を揃えてから本文の手順で微調整したい場合は、当サイトのクライアントダウンロードページから現行ビルドを取得できます。

→ Clash を無料ダウンロードし、OpenRouter の API と静的取得を安定させる

ダウンロードページへ進む