メインコンテンツへスキップ
OpenAI Decisions API
MixRoute の OpenAI 互換 Decisions エンドポイントで、共通の入力に名前付きの質問を行い、型付きの回答を取得します。モデルは gpt-6-luna を使用します。Jev System One とは別のプロトコルです。

接続方法

POST https://api.mixroute.ai/v1/decisions Authorization: Bearer $MIXROUTE_API_KEY と Content-Type: application/json を送信します。API キーはサーバー側で保持してください。モデルとチャネルの利用可否はアカウントに依存します。モデル一覧に掲載されていても、すべてのエンドポイントが利用できるとは限りません。
state ではなく input を使用します。questions は名前を指定できる配列で、質問 ID をキーにしたオブジェクトではありません。真偽判定は noul ではなく predicate、分類は choices、評価は levels を使い、Jev の criteria は使いません。回答の answers も配列です。Jev の仕様は System Oneを参照してください。

リクエストパラメーター

質問のフィールド

回答の型

どの質問も要求した型の代わりに type=refusal を返す場合があります。他の質問には回答が返ることもあります。name または質問順で対応付け、フィールドを読む前に type を確認し、拒否を明示的に処理してください。確率と信頼度は正しさを保証しません。

リクエスト例

呼び出し前に MIXROUTE_API_KEY を設定してください。例は一度だけ送信し、自動再試行しません。クライアントのタイムアウトは推論が未実行であることを意味しません。

レスポンス例

同期 JSON オブジェクトが返ります。Chat Completions の choices 配列や、ポーリングする非同期タスクではありません。確率とトークン使用量はリクエストによって変わります。

構造化データと画像入力

user メッセージの content には input_text(text)、input_image(image_url)、input_json(data)を指定できます。JSON data はオブジェクトまたはオブジェクトの配列です。内部のキーは通常のデータで、画像取得やメッセージ作成を指示しません。JSON 入力の上限はコンテナー 32 階層、10,000 個の値、コンパクトな UTF-8 JSON で 256 KiB です。
画像には公開 HTTP(S) URL または Base64 data URL を使い、file_id は使いません。detail は auto、low、high、original を指定できます。developer/system メッセージはテキスト、assistant メッセージは出力テキストまたは拒否項目です。ツール結果は call_id で呼び出しと対応付けます。このプロトコルはファイル、音声、項目参照を受け付けません。これらはプロトコル上の形式で、拡張入力の利用可否は MixRoute のルートに依存します。 画像 URL を公開アクセス可能な商品画像、または Base64 data URL に置き換えてください。

任意のプロンプトキャッシュ

共有 input のキャッシュには少なくとも 1,024 トークンが必要です。questions は再利用する入力プレフィックスに含まれません。既定では暗黙の区切りを使います。明示的な区切りは共有 input のテキスト・画像項目に prompt_cache_breakpoint: {"mode": "explicit"} を設定します。prompt_cache_options.mode=explicit で区切りがない場合、キャッシュは無効です。質問の instructions にキャッシュの区切りは指定できません。上流の割引や価格がそのまま MixRoute に適用されるとは限りません。

エラーと課金

先に HTTP ステータスを確認してください。ゲートウェイのエラーには error.message、error.type、error.code、error.param が含まれる場合があります。param は空の場合もあります。問い合わせには x-oneapi-request-id を保持し、API キー全体をログに残さないでください。
usage と現在のモデルマーケットプレイスで課金を確認してください。Responses や Chat Completions の料金が Decisions に適用されるとは限りません。実際の料金はアカウント倍率とルートの価格設定によって決まります。