モデル · Ephemeral ドキュメント

モデルカタログには、実行で使えるモデルと、実行でモデルを指定しなかった場合に適用されるデフォルトのモデルが一覧されています。API キーは不要です。

GET/v1/models

このインストールのカタログを返します。

レスポンス

itemsarray

対応しているモデル。ID 順。

default_modelstring

実行に model フィールドがない場合に使われるモデル。

custom_models_allowedboolean

items にないモデルを、実行で指定できるかどうか。

各アイテム

idstring

model として渡す値。anthropic/claude-haiku-5.5 など。

namestring

表示名。

context_lengthinteger

トークン数で表したコンテキストウィンドウ。プロバイダーが公開している場合のみ。

pricingobject

プロバイダーの価格。トークンあたりの米ドルを、10 進数の文字列で表します。prompt は入力、completion は出力です。

supported_parametersstring[]

プロバイダーがこのモデルで対応しているリクエストパラメーター。公開されている場合のみ。

ターミナル

curl $EPHEMERAL_URL/v1/models

JSON

{
  "items": [
    {
      "id": "anthropic/claude-haiku-5.5",
      "name": "Anthropic: Claude Haiku 5.5",
      "context_length": 1000000,
      "pricing": {
        "prompt": "0.0000001",
        "completion": "0.0000005",
        "input_cache_read": "0.00000001",
        "input_cache_write": "0.000000125",
        "input_cache_write_1h": "0.0000002",
        "overrides": [{ "min_prompt_tokens": 100000, "prompt": "0.0000005", "completion": "0.0000025" }]
      },
      "supported_parameters": ["max_tokens", "reasoning", "tool_choice", "tools"]
    }
  ],
  "default_model": "anthropic/claude-haiku-5.5",
  "custom_models_allowed": false
}

ホスト型のカタログ

ホスト型サービスのカタログには、Ephemeral が安全に課金できるモデルが並びます。入力と出力のトークン価格があり、事前に上限を見積もれないその他の課金がないモデルが掲載されます。キャッシュされた入力と、長いコンテキストの価格帯 (overrides) は問題ありません。各呼び出しは、モデルで最も高い価格帯で承認され、プロバイダーが報告した額が請求されます。モデルが対応するパラメーターをプロバイダーが公開している場合、エージェントはツール呼び出しで動作するため、その一覧に tools が含まれている必要があります。custom_models_allowed は false です。

カタログは 1 分間キャッシュされます。価格はモデルを呼び出すたびに再確認され、各呼び出しは、その時点の価格で実行の予算に対して承認されます。モデルが条件を満たさなくなった場合、そのモデルへの呼び出しは拒否され、実行は失敗します。予算と請求をご覧ください。

ホスト型の実行で送れるのはテキストのみです。モデルへの画像、音声、ファイルの入力は拒否されます。

セルフホストのカタログ

セルフホストのインストールで一覧されるのは、設定済みのデフォルトのモデルだけで、custom_models_allowed は true です。実行では、推論エンドポイントが受け付ける任意のモデル ID を指定できます。カタログが推論の認証情報を照会したり公開したりすることはありません。