Ox Alphaストリーミング：ライブレスポンス向けAPIセットアップガイド

Ox Alphaストリーミングは、生成全体が完了するまで待つのではなく、レスポンスが生成されるそばから受け取るためのAPIワークフローです。OpenRouterでは、Ox Alphaをコーディング、継続的なエージェント作業、本番ワークロード、テキストと視覚的コンテキストを組み合わせるタスク向けの推論モデルとして掲載しています。モデルはスラッグ stealth/ox-alpha で識別されます。

プロバイダーは、プレビュー期間中の匿名の第三者運営者として説明されています。OpenRouterはそのプロバイダーにリクエストをルーティングしますが、自身をモデルの開発者、所有者、プロバイダーとは位置づけていません。この区別は、データ保持条件、運用上の責任、本番利用への適合性を確認する際に重要です。

OpenRouterのモデルページには、1Mコンテキストウィンドウ、テキスト・画像・動画入力への対応、テキスト出力が記載されています。また、掲載上のリリース日は 2026年8月20日 です。これはプレビュー形式のステルスモデルであるため、重要なアプリケーションで特定のモダリティ、制限、プロバイダーポリシーを前提とする前に、現在の動作を確認してください。

最も簡単なセットアップ方法は、OpenRouter APIキーを作成して環境変数に保存し、stealth/ox-alpha を使ってリクエストを送信することです。OpenRouterはAPIがOpenAI互換であると説明しているため、ベースURL、認証設定、モデルスラッグを変更することで、多くの既存SDKパターンを利用できます。

本番用APIキーをブラウザーコード、公開リポジトリ、スクリーンショット、クライアント側アプリケーションに直接配置してはいけません。サーバー側のルートでユーザーリクエストを受け取り、秘密キーを付加してプロバイダーを呼び出し、アプリケーションに必要なデータだけを返すようにしてください。

基本的な環境設定は次のとおりです。

export OPENROUTER_API_KEY=sk-or-v1-...

リクエストエンドポイントは POST 操作です。必須ヘッダーは、コンテンツタイプとBearer認証です。OpenRouterでは、ランキングや関連するプラットフォーム表示でアプリケーションを識別するための任意ヘッダーとして、HTTP-Referer と X-Title もドキュメント化されています。

OpenRouterでは、ストリーミングをサーバー送信イベントのワークフローとして説明しています。リクエスト本文で "stream": true を設定すると、モデルが出力を生成するにつれて、サーバーはイベントデータを段階的に返します。クライアントは空でない各テキストデルタをバッファに追加し、段階的に描画する必要があります。

最小限のcURLリクエストは次のようになります。

curl -N -H "Content-Type: application/json" -H "Authorization: Bearer $OPENROUTER_API_KEY" -d '{"model":"stealth/ox-alpha","stream":true,"messages":[{"role":"user","content":"Explain recursion in simple terms."}]}'

-N オプションを使うと、不要なバッファリングなしでcURLにストリームを表示させやすくなります。アプリケーションでは、同等の動作にSSE対応パーサー、または非同期イテレーターを公開するSDKが必要です。

OpenRouterのTypeScript SDK例では、openrouter.chat.send を使用し、モデルとメッセージを渡して、返されたチャンクを反復処理します。テキストは chunk.choices[0]?.delta?.content から読み取ります。最後のチャンクには、利用可能な場合、推論トークンの詳細を含む使用量情報が含まれることもあります。

ユーザー向けアプリケーションでは、蓄積された回答とトランスポート状態を分離してください。これにより、すでに受信したテキストを壊さずに、「接続中」「生成中」「完了」「失敗」を表示できます。

堅牢なストリームハンドラーでは、次の点にも対応する必要があります。

• サーバーが完了を通知したら読み取りを停止する。
• 最終的な使用量オブジェクトが届く前に接続が終了するケースに対応する。
• プロバイダーの生のエラーをエンドユーザーに表示しない。
• 再試行が提示された場合、部分的に受信したテキストを保持する。
• ユーザーがページを離れたりStopを押したりしたときにリクエストをキャンセルする。
• プライベートなプロンプト内容を不必要に記録せず、リクエスト時間を記録する。

OpenRouterが公開したスナップショットには、Ox Alphaに関する複数の運用指標が示されています。掲載されたプロバイダーの概要では、P50レイテンシが 5.30秒、スループットが 毎秒23トークン でした。より広いパフォーマンスパネルには、表示された測定ビュー全体の平均P50スループット36トークン/秒、平均P50レイテンシ3.38秒など、追加のパーセンタイル平均も表示されていました。

これらの数値を、すべての地域、プロンプト、SDK、期間に対する保証とみなしてはいけません。レイテンシは、プロンプトサイズ、出力長、トラフィック、プロバイダーの負荷、ツールの使用、タスクの複雑さによって変化します。ストリーミングは、完全な完了を待たずにユーザーが出力を見られるため、体感上の応答性を向上させますが、生成全体の時間を必ずしも短縮するわけではありません。

取得期間の3日間について、ページには 99.99%の稼働時間 と 99.51%の可用性 が表示されていました。また、掲載プロバイダーの平均ツール呼び出しエラー率は 2.27%、平均キャッシュヒット率は 81.72% でした。これらの指標は公開集計値と異なる可能性があるため、自分のワークロードを監視してください。

本番のエージェントワークフローでは、指数バックオフを伴う回数制限付き再試行を使用してください。再試行は、実行中の操作に対して安全でなければなりません。レスポンスストリームが切断されたという理由だけで、外部アクションを自動的に繰り返さないでください。部分的な回答とアクションの完了は異なる状態であるため、ツール呼び出しには追加の検証が必要です。

Ox Alphaストリーミングは段階的に導入してください。まず、単純なテキストのみのリクエストを検証します。次に、より長いプロンプト、構造化出力、対応している場合は画像または動画入力、ツールを有効にしたエージェントタスクをテストします。この順序で進めることで、診断が難しくなる前に統合エラーを切り分けられます。

実用的なトラブルシューティング手順は次のとおりです。

1. サーバー上に環境変数が存在することを確認する。
2. Bearerトークンが正確に1回だけ付加されていることを確認する。
3. モデルスラッグが stealth/ox-alpha であることを確認する。
4. リクエスト本文が有効なJSONであることを確認する。
5. "stream": true が引用符付きの文字列ではなくBoolean値であることを確認する。
6. イベントの解析を試みる前に、最初のレスポンスステータスを確認する。
7. プロンプト、キー、機密性の高い出力を伏せたうえで、トランスポートメタデータを記録する。
8. 失敗を安全に繰り返せる場合にのみ再試行する。

保守する統合環境では、実装をOpenRouterのOx Alphaモデルおよびプロバイダーページにリンクしてください。このページは、掲載モデルスラッグ、機能、プロバイダー情報、パフォーマンススナップショット、価格表示、クイックスタート例の主要な参照先です。