メインコンテンツへスキップ
POST
構造化された判断を行う
このエンドポイントはベータ段階です。 input と順序付きの questions 配列を POST /v1/decisions に送信すると、質問ごとに 1 つの型付きの回答が、確率とともに同じ順序で返されます。

判断を行う

このリクエストは、各型の質問を 1 つずつ尋ねます。Phaseo API キーと、利用可能な openai/gpt-6-luna のルートが必要です。
レスポンス(値は説明用です):

質問を書く

input は文字列、または user メッセージの配列です。メッセージの content は文字列、または input_text、input_image、input_audio、input_video のパーツのリストです。name は任意です。回答は、名前のない質問や名前が重複する質問も含め、リクエストの順序を保ちます。 1 つのリクエストに含められる質問は最大 128 個です。ただし google/gemini-decision-1 は最大 1,000 個、parallel/decisions-fast は最大 100 個、Clef は最大 64 個まで受け付けます。モデルの上限を超えるリクエストは 400 を返します。 真偽値の選択肢は真偽値として返されます。モデルが質問への回答を拒否した場合、その質問には type: "refusal" が返されます。モデルが対応する型は、モデルを選ぶに記載しています。 画像は data URL として input_image パーツに入れます。ホストされた HTTPS の画像 URL は Base Labs のモデル(baselabs/elephant-1、baselabs/mammoth-1、baselabs/joey-1)でのみ使え、Amazon S3、Google Cloud Storage、Azure Blob Storage 上にある必要があります。1 つのリクエストには最大 128 枚の画像を含められ、Luna はこれを受け付けますが、他のプロバイダーはより低い上限を設けています。画像の detail の明示的な指定と safety_identifier には OpenAI のルートが必要です。

従来の state 形式を使う

state と名前付き質問のマップを使うリクエストも引き続き動作し、同じ名前をキーとする回答を返します。Together Tev(together/tev1-4b-experimental)は確率なしのラベルを返すためこの形式が必要で、choice の質問にのみ回答します。Respan Span-01 もこの形式を使います。形式を混在させないでください。input と state または images を一緒に送ると 400 が返されます。
  • state: 評価する情報を保持する文字列、オブジェクト、または配列。
  • questions: 最大 128 個の名前付きの質問(上限が高いモデルではそれ以上)。それぞれ type を noul(はい/いいえ)、choice、score のいずれかに設定し、instructions を指定します。choice の質問は、選択肢から説明への対応を criteria のマップとして受け取り、score の質問は、2 つ以上のレベルの説明を criteria の配列として受け取ります。
  • locate の質問は instructions だけを使い、images のない文字列の state が必要です。Perplexity Decider を参照してください。
  • images: 最大 4 枚の PNG、JPEG、WebP の画像。data: URL または { "content_type", "base64" } オブジェクトで指定します。
  • model: 省略した場合のデフォルトは typesafe/jev-1.13.0 です。
回答には questions と同じキーが使われます。choice の回答には選ばれた選択肢、確率、信頼度が、noul の回答には 0〜1 の確率が、score の回答には確率で重み付けしたスコア、凡例、確率、信頼度が含まれます。

モデルを選ぶ

これらのモデルを呼び出す前に、モデルの提供状況を確認してください。 料金が記載されているすべてのモデルで、出力トークンは無料です。

TypeSafe Jev

Jev 1.13 には typesafe/jev-1.13.0 を、最新の Jev リリースに追従するには typesafe/jev-latest を使います。上流の質問のセマンティクスについては、TypeSafe の API リファレンスを参照してください。 対応する TypeSafe のルートでは、Jev 1.13 と 1.14 は、input_image または従来の images フィールドでインラインの PNG または JPEG 画像を受け付けます。Phaseo は TypeSafe の画像アセットを構築し、画像対応を自動で有効にします。画像は TypeSafe の画像の制限を満たす必要があります。1 枚あたり最大 16 MiB、各辺 256〜1568 ピクセル、合計 78,400 ピクセル以上です。TypeSafe は寸法とエンコードを検証し、拒否された画像のサイズ変更は行いません。対応付けられた上流の JSON 本文は 32 MiB までです。画像トークンには通常の入力料金が適用されます。 box(Jev 1.14 などの対応ルート)は画像を必要とし、criteria は受け取らず、1 つのバウンディングボックスと信頼度を返します。各辺は左上隅から測った 0〜1 の値です。Box は常に矩形を返すため、対象が存在しない可能性がある場合は、存在を確認する predicate の質問と組み合わせてください。従来の images フィールドでは images[0] を、順序付きの入力では最初の画像または [Image 0] を参照します。Box のコントラクトを参照してください。 provider_options.typesafe.long_context を true に設定すると、リクエストあたりと質問あたりのコンテキスト上限が、デフォルトのリクエストあたり 64k、質問あたり 32k から 262k トークンに引き上げられます。ロングコンテキストのトークンあたりの料金は変わりません。画像、Box、ロングコンテキストは上流の実験的な機能です。

Cloudflare Clef と Clef Flash

cloudflare/clef と cloudflare/clef-flash は Cloudflare Workers AI で動作します。コンテキストウィンドウは Clef が 65,536 トークン、Clef Flash が 24,576 トークンです。
images は data:image/png;base64,... の文字列も受け付けます。Clef は最大 4 枚の PNG、JPEG、WebP の画像を受け付け、1 枚あたり最大 4 MiB かつ 16 メガピクセル、デコード後の画像データは合計 8 MiB まで、リクエスト本文は 13 MiB までです。リモート URL には対応しておらず、画像の形式と寸法は Cloudflare が検証します。画像に対応していないモデルは、画像を含むリクエストを拒否します。 Clef が受け付ける質問は最大 64 個で、ID は最大 100 文字の英字、数字、アンダースコア、ドット、ハイフンです。choice の質問には 2〜255 個の選択肢、score の質問には 2〜10 個のレベルが必要です。Cloudflare の Clef のドキュメントを参照してください。

Cloudflare Clef Omni

cloudflare/clef-omni は、テキスト、画像、音声、動画を受け付けます。音声と動画のパーツは入力形式に対する Phaseo の拡張で、OpenAI のルートはテキストと画像のみを受け付けます。この例を送信する前に、プレースホルダーの音声バイトと動画 URL を自分のメディアに置き換えてください。
音声は、format: "wav" または "mp3" を付けた input_audio.data として、または公開 HTTPS URL かインラインの音声 data URL を指定した input_audio.url として送信します。input_video.video_url は、公開 HTTPS URL またはインラインの MP4/WebM data URL を保持する、文字列または { "url": "..." } を受け付けます。リモートサーバーは一致する Content-Type を返す必要があります。Phaseo はサイズの制限と、プライベートアドレスおよびリダイレクトの確認を行いながら URL を取得し、メディアを Cloudflare 向けに埋め込みます。プロバイダーの認証情報がメディアサーバーに送信されることはありません。 Cloudflare はメディアのエンコード、画像の寸法、クリップの長さを検証し、動画を 1 秒あたり 2 フレームでサンプリングします。リクエスト内のすべての動画にサウンドトラックがある場合は、動画のサウンドトラックが使われます。メディアのトークンはコンテキストと課金に計数されます。Phaseo は Cloudflare が報告する入力使用量に基づいて精算し、音声や動画に別途料金を加えることはありません。Cloudflare の Omni のコントラクトを参照してください。

Liquid D1.2 と D1.2 Ultra

liquid-ai/d1.2 と liquid-ai/d1.2-ultra は従来の state 形式を使い、最大 4 枚の画像と最大 8 個の音声クリップを受け付けます。audio は base64 の data: URL(WAV、MP3、FLAC、M4A、OGG、URL ごとに 24 MiB まで、音声データでは約 18 MiB)で送ります。リモートの音声 URL は使えません。noul、choice、score に加えて、次の質問タイプに答えます。 choice の質問に multiple: true を指定すると、当てはまる選択肢をすべて choices で返し、選択肢ごとの probabilities も返します。ほかのモデルはこれらの質問タイプに 400 を返し、multiple の質問には 1 つの選択肢で答えます。音声入力に対応しないモデルは audio を無視します。liquid-ai/d1、liquid-ai/d1.1、liquid-ai/d1-ultra はテキストと画像を受け付け、noul、choice、score に答えます。

Liquid D1 と Perplexity Decider

Liquid D1(liquid-ai/d1:free)は、実験的な早期アクセス期間中は無料です。Perplexity Decider V1.3(perplexity/pplx-decider-v1.3、または perplexity/pplx-decider-latest)と Decider Flash V1.3(perplexity/pplx-decider-flash-v1.3、または perplexity/pplx-decider-flash-latest)には、Phaseo に Perplexity のプロバイダー認証情報が必要です。画像の state には PNG、JPEG、WebP の base64 data URL を使い、リモートの画像 URL には対応していません。これらは locate の質問にも回答し、文字列の input または state のうち instructions(例: "email address")に一致する部分を返します。各スパンには原文どおりの text、Unicode コードポイント単位の start と end(end は含みません)、値が大きいほど確信が高い score が含まれます。一致がない場合 spans は空です。Locate は criteria を使わず、画像・音声・動画を受け付けず、対応を明記したモデルでのみ動作します。それ以外のモデルは 400 を返します。Perplexity は最大 8K トークンの入力で学習させています。どちらでも、choice の質問は最大 255 個の選択肢を、score の質問は最大 10 個のレベルを受け付けます。

Inception Mercury Decide

inception/mercury-decide は、テキストまたは JSON の根拠を受け付けます。choice の質問は最大 255 個の選択肢を、score の質問は最大 10 個のレベルを受け付けます。画像、ストリーミング、ツール呼び出しには対応していません。$0.02 の入力料金は Inception の 50% プロモーションによるもので、終了日は公表されていません。使用する前に現在の上流の料金を確認してください。

Microsoft Decision

microsoft/microsoft-decision-1 は Azure Foundry のデプロイメントで動作し、最大 32,768 トークンのテキストまたは JSON の根拠を受け付けます。メディア、ストリーミング、ツール、safety_identifier、service_tier には対応していません。Microsoft のガイドを参照してください。

Respan Span-01

Span-01 は従来の形式を使います。state は会話スパン、つまり先行するメッセージの input 配列と、アシスタントの output メッセージである必要があります。noul の質問にのみ回答します。noul の値はその振る舞いが存在する確率で、probabilities には存在しない確率と観察できない確率も含まれます。
レスポンスは次のようになります。
respan/span-01:free は 1 日あたりの上限がある無料の Lite モデルで、Respan の span-01-free モデルに対応します。respan/span-01 は span-01-pro に対応し、Respan が課金します。Span-01 は早期アクセス中です。Respan が組織に対して有効にする必要があり、どちらのモデルを呼び出す前にも、Phaseo で Respan のプロバイダー認証情報として Respan API キーを追加してください。

承認

Authorization
string
header
必須

Bearer トークンによる認証

ボディ

application/json

OpenAI 形式を推奨します。従来形式も対応します。回答はリクエスト形式に従います。混在させないでください。

model
string
必須

Phaseo の正規モデル ID またはプロバイダーのモデルエイリアス。

Minimum string length: 1
input
必須

テキストまたはインライン画像付きメッセージ。音声と動画は対応モデル向けの Phaseo 拡張であり、OpenAI の判断ルートでは利用できません。

Maximum string length: 10485760
questions
object[]
必須
Required array length: 1 - 1000 elements
models
string[]

model の後に試行される、任意の順序付きフォールバックモデルです。model は必須で、常にプライマリモデルです。試行が 429、500、502、503、504 で失敗すると次のエントリーが試行され、その他のエラーはそのまま返されます。最大 25 個のモデル ID またはプリセットを指定でき、重複や model と同じエントリーは無視されます。各試行は個別のリクエストとして検証、記録、課金され、レスポンスの model フィールドとルーティングトレースには、リクエストを処理したモデルが表示されます。ストリーミングリクエストは最初のバイトの送信前にのみフォールバックし、動画と音楽のジョブは送信時にのみフォールバックします。Batch、realtime、council のリクエストは models を拒否します。動的ルートで設定されたフォールバックが優先され、phaseo/auto は models と併用できません。

Required array length: 1 - 25 elements
Minimum string length: 1
例:
provider_options
object
safety_identifier
string | null

不透明なユーザー識別子。OpenAI ルートのみ。

Maximum string length: 128
meta
boolean
デフォルト:false
echo_upstream_request
boolean
debug
object

ゲートウェイのデバッグ設定です。これらのフラグがプロバイダーに転送されることはありません。

provider
object

ゲートウェイでの選択に使用するプロバイダーのルーティング設定。

routing
object

ゲートウェイでの選択に使用するプロバイダーのルーティング設定。

metadata
object

レスポンス

200 - application/json

構造化された判断のレスポンス

input/配列は順序付き回答。従来 state/マップは名前付きマップ。

model
string
必須
answers
object[]
必須

名前なしや同名の質問も含め、質問順に1つずつ回答。

usage
object
必須
request_id
string | null
meta
object
最終更新日 2026年11月16日