メインコンテンツへスキップ
GET
ゲートウェイモデルを一覧表示
GET /v1/models を呼び出すと、現在ルーティングできるモデルが一覧表示されます。把握されているものの現在は利用できないモデルも含めるには、availability=all を設定します。
各モデルの offers には、プロバイダールートごとに 1 つのエントリーがあります(抜粋。値は説明用です)。
本番トラフィックは、routable が true の提供内容にのみルーティングしてください。status_reason は、提供内容がプレビュー限定または無効である理由を示します。完全なスキーマは下にあります。 GET /models/me は、同じ一覧にキーのガードレールを適用して返します。対象は、ワークスペースのプライバシーとプロバイダーのルール、およびキーの部署、そのメンバー、キー自体のガードレールです。モデルのルールでブロックされたモデルと、許可されたプロバイダーがないモデルは含まれず、各モデルにはリクエストをルーティングできるオファーだけが残ります。GET /models と同じフィルターを使えます。 レスポンスには access も含まれます。ルールが適用されているか(restricted)、ルールで除外されたモデル(hidden_model_count と hidden_models、ID と名前付き)、一部のプロバイダーが除かれた掲載モデルの数(limited_model_count)を返すので、モデルが見当たらない理由を伝えられます。

一覧を絞り込む

複数の値を取るフィルターは、繰り返しのパラメーターまたはカンマ区切りのリストを受け付けます。 1 つのモデルのプロバイダールート、パラメーターの詳細、料金を確認するには、GET /models/{author}/{slug}/endpoints を呼び出します。

提供内容ごとのサービスティアを確認する

offers の各エントリーには service_tiers が含まれます。これは、そのプロバイダーの提供内容が受け付けるサービスティアです。flex、priority、standard、ultrafast のうちの一部をアルファベット順に並べたもので、priority は Fast ティアです。プロバイダールートに、そのティアについて有効で現在適用中の料金がある場合にティアが表示され、1 つのティアのみを提供するルートにはそのティアだけが表示されます。一部のティアは、表示されていない別のティア専用のプロバイダールートでも利用できます。pricing の料金は引き続き標準ティアの料金です。

OpenAI 形式で一覧を取得する

OpenAI のモデル一覧のレスポンスを期待するクライアントには、GET /v1/models?format=openai を使います。デフォルトの format=json は、Phaseo のより詳しいモデルのメタデータを返します。
OpenAI 形式では、ネイティブの JSON と同じ認証、リージョンごとの提供状況、ワークスペースのプライベートモデル、フィルターが使われます。limit を指定しない限り一致するすべてのモデルが返され、offset は引き続き適用されます。ID は推論用の Phaseo の正規の形式のままです。created にはカタログのリリース日(不明な場合は 0)が、owned_by にはカタログの組織、ワークスペースのモデルでは private、不明な場合は phaseo が入ります。

モデル一覧をキャッシュする

カタログのレスポンスは 5 分間キャッシュされ、キャッシュの再検証中はさらに 5 分間提供されることがあります。これは現在のカタログの JSON、RSS、Atom の表現に適用されます。リリースフィードには、より短い独自のポーリング用キャッシュがあります。 JSON と OpenAI 形式のレスポンスには、弱い ETag ヘッダー(W/"…")が含まれます。これは、ページ上のモデル、limit、offset、total、または形式が変わると変化します。gateway_region は無視されるため、別のリージョンから提供された同じカタログには同じ ETag が付きます。弱い ETag であるのはこのためで、同じ値を持つレスポンスは同等ですが、バイト列は異なることがあります。RSS、Atom、エラーのレスポンスには含まれません。 保存した値を、そのまま If-None-Match で送り返してください。カタログが変わっていない場合、レスポンスは本文のない 304 Not Modified で、ETag、Cache-Control、Vary ヘッダーが繰り返されます。変わっている場合は、新しい一覧と新しい ETag を含む通常の 200 が返されます。If-None-Match はカンマ区切りのリストと * も受け付け、比較は弱い比較なので、値は W/ プレフィックスの有無にかかわらず一致します。
304 により転送と解析の手間が省けます。それでもサーバーはリクエストを評価し、カタログを読み込んで ETag を再計算します。約 15 分ごとのポーリングで十分で、カタログが変わったときにだけ一覧を再ダウンロードすれば済みます。ページ、フィルターの組み合わせ、形式ごとに値が異なるため、ETag はリクエスト URL ごとに 1 つ保持してください。

承認

Authorization
string
header
必須

Bearer トークンによる認証

ヘッダー

If-None-Match
string

同じ URL に対する以前の JSON 形式または OpenAI 形式のレスポンスの ETag。まだ一致する場合、レスポンスは本文なしの 304 Not Modified になります。カンマ区切りのリスト、弱いバリデーター (W/)、* を受け付けます。

クエリパラメータ

モデル ID、名前、説明、組織を対象に、大文字と小文字を区別せず検索します。

Maximum string length: 200

プロバイダーまたはモデルの組織を、大文字と小文字を区別せず検索します。

Maximum string length: 100
input_modality
enum<string>

対応する入力モダリティを必須とします。

利用可能なオプション:
text,
image,
audio,
video
minimum_context_tokens
number

入力コンテキストに少なくともこの数のトークンを要求します。

必須範囲: x >= 0
maximum_input_price_per_million
number

入力トークン 100 万個あたりの上限価格(米ドル)。

必須範囲: x >= 0
gateway_available_only
boolean
デフォルト:false

ルーティング可能なゲートウェイの提供ルートが少なくとも 1 つあるモデルのみを返します。

sort_by
enum<string>
デフォルト:relevance

モデル検出結果の並べ替えに使うフィールド。

利用可能なオプション:
relevance,
input_price,
output_price,
context_length,
provider_count
sort_order
enum<string>

任意の並べ替え方向。価格は標準で昇順、それ以外の数値は標準で降順に並べ替えます。

利用可能なオプション:
asc,
desc
include
enum<string>[]

parameter_specs を指定すると、各オファーのリクエストパラメーターを標準形式で追加します。

利用可能なオプション:
parameter_specs
endpoints
string[]

エンドポイントで絞り込む

organisation

組織で絞り込む 組織の識別子です。

利用可能なオプション:
01-ai,
adept,
ai21,
aion-labs,
aisingapore,
alibaba,
allenai,
amazon,
anthracite-org,
anthropic,
arcee-ai,
baai,
baichuan,
baidu,
bigcode,
black-forest-labs,
bytedance,
bytedance-seed,
cogito,
cognitivecomputations,
cohere,
crofai,
cursor,
cyfragovpl,
databricks,
dealignai,
decart,
deepseek,
dots-studio,
early-access,
eleven-labs,
essential-ai,
fastino,
fish-audio,
github,
google,
gryphe,
hexgrad,
ibm,
ibm-granite,
inception,
inclusionai,
inference-net,
inflection,
intfloat,
jetbrains,
kblab,
kling,
kuaishou,
kwaipilot,
kwaivgi,
lg,
lightricks,
liquid-ai,
mancer,
medaibase,
meituan,
meta,
microsoft,
mindai,
minimax,
mistral,
mistralai,
moonshotai,
morph,
naver-hyperclova,
near-ai,
nex-agi,
nous,
nousresearch,
novasearch,
nvidia,
openai,
openbmb,
opencompass,
opengvlab,
orcarouter,
ornith,
perceptron,
perplexity,
phala,
pixverse,
poe,
poolside,
prime-intellect,
prism-ml,
qwen,
reka,
relace,
runway,
sakana,
sao10k,
sapiens-ai,
sentence-transformers,
sference,
shanghai-ai-laboratory,
shengshu-ai,
snowflake,
sourceful,
spacex-ai,
speakleash,
stability-ai,
stealth,
stepfun,
suno,
tencent,
thedrummer,
thinking-machines,
undi95,
upstage,
venice,
vercel,
villanova-ai,
voyage,
windsurf,
writer,
xai,
xgenerationlab,
xiaomi,
z-ai,
zyphra
provider
string[]

プロバイダー ID で絞り込む

provider_status
string[]

プロバイダーのロールアウト状態で絞り込む

provider_routing_status
string[]

プロバイダーのルーティング状態で絞り込む

model_routing_status
string[]

モデルのルーティング状態で絞り込む

capability_status
string[]

プロバイダーの機能状態で絞り込む

provider_availability_status
string[]

プロバイダーの利用可能性状態で絞り込む

provider_availability_reason
string[]

プロバイダーの利用可能性の理由で絞り込む

status
string[]

モデルの状態で絞り込む

input_types
string[]

入力タイプで絞り込む

input_modalities
string[]

input_types の公開エイリアスです。

output_types
string[]

出力タイプで絞り込む

output_modalities
string[]

output_types の公開エイリアスです。

params
string[]

パラメーターで絞り込む

supported_parameters
string[]

params の公開エイリアスです。

availability
enum<string>
デフォルト:active

利用可能性フィルターです。active はパブリックにルーティングできるモデルのみを返し、all はルーティングできない利用可能性レコードも含みます。

利用可能なオプション:
active,
all
limit
integer
デフォルト:50

結果の件数を制限

必須範囲: 1 <= x <= 250
offset
integer
デフォルト:0

ページネーションのオフセット

必須範囲: 0 <= x <= 5000
format
enum<string>
デフォルト:json

応答形式。既定は Phaseo 独自の JSON です。OpenAI 形式は limit が指定されない限り、絞り込み結果の全一覧を返します。

利用可能なオプション:
json,
openai,
rss,
atom
feed
enum<string>

format のエイリアスです。json、rss、atom を指定できます。

利用可能なオプション:
json,
rss,
atom

レスポンス

モデル一覧

ok
boolean
必須
例:

true

availability_mode
enum<string>
必須
利用可能なオプション:
active,
all
例:

"active"

limit
integer
必須
必須範囲: 1 <= x <= 250
例:

50

offset
integer
必須
必須範囲: 0 <= x <= 5000
例:

0

total
integer
必須
必須範囲: x >= 0
例:

128

models
object[]
必須
access
object

/models/me のみが返します。検索とページ分割の前に、呼び出し元のガードレールが一覧から除外した内容です。

最終更新日 2026年11月16日