対応プロバイダー
- OpenAI
- Google Gemini
- Anthropic Claude
- Novita AI
- OpenRouter
- Google Vertex AI
- Amazon Bedrock
- Azure OpenAI
- OpenAI-compatible
- Anthropic-compatible
適したケース: 最新の GPT モデルと、安定したパフォーマンスが必要な場合。APIキーの取得:
- OpenAI API Keys にアクセスします
- Kodus 用に新しいキーを作成します
- 請求情報を追加します
https://your-gateway.example.com/v1のように、API バージョンを含めてください。Kodus は<Base URL>/responsesを呼び出し、<Base URL>/modelsからモデルを一覧取得します。- ゲートウェイがチャット補完のみを提供する場合は、代わりに OpenAI-compatible として接続してください。
- Kodus がそこにキーを送信するため、URL は
https://を使用し、パブリックなアドレスに解決される必要があります。セルフホスト環境のプライベートネットワーク上にあるゲートウェイはサポートされていません。 - リクエストは
store: falseで送信されるため、ゲートウェイにも OpenAI にもリクエストの保存は求められません。 - OpenAI 自身のモデル ID(例:
gpt-5.4)を使用してください。ゲートウェイが名前を変更したモデルは reasoning モデルとして認識されないため、reasoning レベルは送信されません。 - ここではサポートされないもの:キーに加えて独自のヘッダーが必要なゲートウェイ(Portkey、Cloudflare AI Gateway)と、独自の Azure OpenAI プロバイダーがある Azure OpenAI。
Kimi(Moonshot)と GLM(Z.ai)を接続する
Moonshot と Z.ai はそれぞれ、トークン従量課金の Developer API とは別のエンドポイントでサブスクリプションプランを提供しています。各プランは独自のキーを持つ別のアカウントです。お持ちのキーに対応するベース URL を選択してください。 Moonshot タイルは Developer API の Anthropic 互換エンドポイント(https://api.moonshot.ai/anthropic)を使用します。Z.ai タイルは Z.AI が GLM Coding Plan 向けに案内している https://api.z.ai/api/anthropic を使用します。Z.AI の Developer API を使用する場合は、Custom で OpenAI-compatible を選択し、https://api.z.ai/api/paas/v4/ を入力してください。Kimi Code Plan のキーを使う場合は、Custom で互換プロバイダーを選択し、表のベース URL を入力してください。
- Kimi (Moonshot AI)
- GLM (Z.ai)
Kimi Code Plan では、上限を低い値から始めてアカウントに合わせて調整してください。同時実行数の調整を参照してください。Kimi K2.7 Code は常に reasoning を行います。Kodus は temperature フィールドを非表示にし、リクエストからも省略します。Temperature を参照してください。
OpenRouter のプロバイダーを固定する
OpenRouter はルーターです。モデル(例:moonshotai/kimi-k2)をリクエストすると、複数ある上流プロバイダー(Moonshot 直接、Together、Groq、Fireworks、Novita など)のいずれかに呼び出しを転送します。呼び出しごとに別のバックエンドに振り分けられる可能性があります。便利な反面、気づきにくいばらつきが生じます。
- 品質のばらつき — 上流ごとに精度(FP8、INT4、フル精度)が異なり、同一のプロンプトでも出力に微妙な違いが出ます
- ツール呼び出しの不整合 — バックエンドによっては関数呼び出しの扱いが異なり、不正なツール使用につながります
- reasoning 形式のばらつき — ある上流は
reasoning_effortに従い、別の上流はthinking.enabledのみに従い、さらに別の上流はどちらも無視します - レイテンシの変動 — ルーティングが変わると、p50 が呼び出しごとに 800ms から 4s に跳ね上がることがあります
- レート制限の想定外の発生 — 明示的に選んでいないバックエンドでクォータに達します
固定の方法
BYOK プロバイダーが OpenRouter の場合、Advanced settings パネルに OpenRouter routing セクションが表示され、2 つのフィールドがあります。- Pin providers (in order) — 上流プロバイダー名のカンマ区切りリスト(例:
moonshot, together)。OpenRouter は順番に試し、最初に利用可能なものを使用します。 - Allow fallbacks — オフの場合、固定したプロバイダーがどれも利用できないとリクエストは即座に失敗します。オン(デフォルト)の場合、OpenRouter はそのモデルを提供する他の上流にフォールバックできます。
応用:生の JSON オーバーライド
order と allow_fallbacks 以外のフィールド(例:ignore、data_collection、require_parameters)が必要な場合は、Advanced settings で Thinking / Reasoning を Custom に切り替え(Custom JSON override)、ルーティングのペイロード全体を貼り付けます。reasoning の設定とあわせて providerOptions にマージされます。