Ox Alpha openrouter api：セットアップガイドとAPIの使用方法

Ox Alpha openrouter apiは、コーディング、継続的なエージェント型作業、本番を意識したワークフロー向けの推論モデルを必要とする開発者のために設計されています。OpenRouterでは、Ox Alphaがモデル識別子 stealth/ox-alpha として掲載されているため、この正確なスラッグがリクエスト本文の中心的な値になります。

このモデルはステルスモデルとして紹介されています。OpenRouterは、自社が開発者、所有者、プロバイダーではなく、プレビュー期間中は匿名のサードパーティプロバイダーが運用していると説明しています。プロンプトと生成結果はそのプロバイダーによって保持され、トレーニングには使用されません。一方、その他の利用については、適用されるStealth Model Termsに従います。

現在の掲載情報、料金、プロバイダーのメトリクス、クイックスタートの例については、OpenRouterのOx Alpha API料金・プロバイダーページを参照してください。

最も簡単なセットアップ方法は、OpenRouter APIキーを作成し、ソースコードの外部に保存して、モデルスラッグ stealth/ox-alpha を指定してリクエストを送信することです。OpenRouterのAPIはOpenAI互換と説明されているため、ベースURLとモデル識別子を変更するだけで、多くの既存クライアントを利用できます。

環境のセットアップ

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

本番環境では、保護されたランタイム設定を通じてキーを注入してください。認証ヘッダー、完全なリクエスト本文、アップロードしたメディアのURL、または非公開のプロジェクトデータを含む可能性のあるモデルレスポンスをログに記録しないでください。

TypeScript SDKの例

以下のパターンは、モデルページに示されているOpenRouter SDKの形式に従っています。

import { OpenRouter } from "@openrouter/sdk";

const openrouter = new OpenRouter({
  apiKey: process.env.OPENROUTER_API_KEY
});

const response = await openrouter.chat.send({
  chatRequest: {
    model: "stealth/ox-alpha",
    messages: [
      {
        role: "user",
        content: "Review this function and suggest a safer error-handling approach."
      }
    ],
    stream: false
  }
});

console.log(response.choices[0]?.message?.content);

HTTP-RefererとX-Titleのヘッダーは任意です。OpenRouterによれば、これらを使うとアプリケーションがリーダーボードに表示されやすくなりますが、基本的なリクエストには必要ありません。

Ox Alphaは、明確な目的、関連するプロジェクトコンテキスト、明示的な出力形式をリクエストに含めることで、最も効果を発揮します。コーディングエージェントでは、タスクの説明をリポジトリのコンテキスト、制約、テストコマンド、受け入れ基準から分離してください。

実用的なプロンプト構成には、次の要素が含まれます。

• 目的：変更内容または質問を、直接的な1文で述べます。
• コンテキスト：関連するファイル、インターフェース、ログ、視覚的な参照を含めます。
• 制約：言語バージョン、互換性ルール、セキュリティ要件、禁止されている変更を明確にします。
• 期待する出力：パッチ計画、コード、説明、JSONオブジェクト、レビュー結果などを指定します。
• 検証：テスト、エッジケース、検証チェックリストを求めます。

ストリーミングレスポンス

ストリーミングは、コーディングアシスタント、ターミナル、ユーザーインターフェースに適しています。完全なレスポンスを待つことで応答性が低下する場合に特に有効です。クライアントでは次の処理を行う必要があります。

1. Server-Sent Eventストリームを開きます。
2. 各デルタから利用可能なコンテンツを追加します。
3. レスポンスの完了を検出します。
4. 提供されている場合は、最後のチャンクから使用量情報を読み取ります。
5. 中断やプロバイダーエラーを処理し、不完全な出力を最終コードとして表示しないようにします。

生のリクエストは、次のような一般的な形式で記述できます。

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 this error and propose a minimal fix."}
    ]
  }' \
  https://openrouter.ai/api/v1/chat/completions

構造化された自動化では、response_formatと厳格なスキーマを組み合わせ、別のシステムで使用する前に返されたコンテンツを検証してください。ツール呼び出しについても、必須引数、許可された操作、認可の境界を確認する必要があります。

OpenRouterの掲載情報では、2026年8月22日に取得された時点で、Ox Alphaの入力と出力の両方が無料と記録されています。ページ上ではプロバイダーが1社と報告されているため、このモデルで設定できるプロバイダールーティングの選択肢はありません。OpenRouterはリクエストをそのプロバイダーに直接転送します。

表示されているパフォーマンススナップショットでは、掲載プロバイダーのP50スループットは毎秒23トークン、P50レイテンシーは5.30秒です。これらの数値はページの報告期間における観測値であり、すべてのリクエスト、地域、プロンプトサイズ、ワークロードに対する保証ではありません。

このページでは、表示されているプロバイダーの平均キャッシュヒット率も81.72%と報告されています。キャッシュの動作は実効コストとパフォーマンスに影響する可能性がありますが、アプリケーションの結果はリクエストパターンとプロバイダーの現在の運用状況に左右されます。

本番環境の計画

無料の掲載情報は評価やプロトタイプに役立ちますが、本番運用への準備にはトークン料金以外の要素も関係します。次の点を計画してください。

• 長時間の推論タスクに適したリクエストタイムアウト。
• 一時的な障害に対する、上限付きバックオフを使用したリトライ。
• ツールを使用するワークフロー向けの冪等性対策。
• コードやコマンドが実行レイヤーに到達する前の出力検証。
• レイテンシー、可用性、不正なツール引数、不完全なストリームの監視。
• アプリケーションを停止できない場合に備えた、フォールバックモデルまたはプロバイダー戦略。

Ox Alphaは、テキストと視覚コンテキストを組み合わせたワークフローに対応できます。画像や動画を送信する際は、管理されたURLまたは承認済みのアップロード経路を使用し、不要なデータを最小限に抑え、スクリーンショット、ログ、録画に認証情報が含まれないようにしてください。

コーディングエージェントにおいて最も重要な境界は、モデルの出力と現実の実行処理の間にあります。モデルはコマンド、ファイル変更、ツール引数を提案できますが、アプリケーション側で権限を独立して適用する必要があります。

推奨されるアプリケーション境界

可能な限り、OpenRouterの認証情報は信頼できるバックエンドに保持してください。フロントエンドはユーザーリクエストをサーバーに送信し、サーバー側でモデル選択、プロンプト構築、レート制限、ツール権限、ロギングを管理できます。

継続的なエージェント型作業では、必要以上のコンテンツを保存せずに障害を診断できるだけのテレメトリを記録してください。役立つメタデータには、リクエスト時間、モデルスラッグ、ステータスコード、リトライ回数、ツール名、提供されている場合のトークン使用量などがあります。完全なプロンプトに独自情報が含まれる可能性がある場合は、デフォルトで記録しないようにしてください。