API リファレンス/モデルと料金

モデルと料金

これらのエンドポイントで、いま呼び出せるモデルとそのコンテキスト長、機能、料金を取得できます。モデル表を手作業で管理する必要はありません。

これらのエンドポイントは公開されています。API キーは不要で、現在呼び出せるモデルだけを返します。リクエストは API ホスト、つまりモデル呼び出しと同じ base URL に送信してください。

このページの内容expand_more

モデル一覧link

OpenAI 互換のモデル一覧です。デフォルトではテキストモデルのみを返すため、すべてのエントリをチャットモデルとして扱うクライアントもそのまま動作します。

GET/v1/models
cURL
curl 'https://api.wokey.ai/v1/models'
curl 'https://api.wokey.ai/v1/models?output_modalities=all'

クエリパラメータ

output_modalities
任意。出力タイプで絞り込みます:text、image、video、all、または text,image のようなカンマ区切りの組み合わせ。デフォルトは text です。無効な値を指定すると 400 invalid_output_modalities が返ります。

レスポンスフィールド

id
model として送信するモデル ID。
owned_by
モデルの主要ベンダー。1 つのモデルに複数のベンダーがある場合、完全な一覧は料金カタログの providers にあります。
name
表示名。
context_length
トークン単位のコンテキストウィンドウ。テキストモデルのみ。
max_completion_tokens
1 リクエストあたりの最大出力トークン数。テキストモデルのみ。
architecture
input_modalities と output_modalities はモデルが対応する入力・出力タイプで、こちらが正となります。modality はそれらから生成された表示用の文字列です。
pricing
テキストモデルの料金で、トークンあたりの USD を 10 進数の文字列で表します。prompt は入力、completion は出力、input_cache_read、input_cache_write、input_cache_write_1h はキャッシュの読み取りと書き込みです。モデルが対応していない項目は省略されます。
supported_parameters
モデルが対応していることが確認済みの機能(max_tokens や tools など)。
JSON
{
  "object": "list",
  "data": [
    {
      "id": "deepseek-v4.1-flash",
      "owned_by": "deepseek",
      "object": "model",
      "created": 0,
      "name": "DeepSeek-V4.1-Flash",
      "context_length": 1000000,
      "max_completion_tokens": 393216,
      "architecture": {
        "modality": "text+image->text",
        "input_modalities": ["text", "image"],
        "output_modalities": ["text"]
      },
      "pricing": {
        "prompt": "0.000000075",
        "completion": "0.0000003",
        "input_cache_read": "0.0000000015"
      },
      "supported_parameters": ["max_tokens", "tools"]
    }
  ]
}

サンプルではモデルを 1 つだけ残し、一部のフィールドを省略しています。

  • /models と /v1/models は同じ内容を返します。
  • レスポンスには ETag が付きます。If-None-Match を送信すると、一覧が変わっていない場合は 304 が返るため、ポーリングの負荷は小さく済みます。
  • 一時的に容量が上限に達しているモデルも一覧に残ります。容量が空くまで、そのモデルへの呼び出しは 429 を返します。

料金カタログlink

現在呼び出せるすべてのモデルの料金を、テキスト・画像・動画共通の 1 つの形式で返します。モデル一覧と異なり、デフォルトですべてのタイプを返します。

GET/v1/models/pricing
cURL
curl 'https://api.wokey.ai/v1/models/pricing?model=deepseek-v4.1-flash'
curl 'https://api.wokey.ai/v1/models/pricing?output_modalities=image,video'

クエリパラメータ

output_modalities
任意。値はモデル一覧と同じで、デフォルトは all です。
model
任意。1 つのモデルを返します。大文字・小文字を区別せずに照合します。存在しないモデル ID の場合は空の一覧が返ります。

レスポンスフィールド

owned_by / providers
owned_by は主要ベンダーです。providers は現在有効なベンダーをデフォルトの優先順に、provider リクエストパラメータが受け付けるベンダー ID で列挙します。どのベンダーがリクエストを処理しても料金は同じです。
pricing_skus
料金項目の一覧で、すべてのモデルで同じ形式です。
pricing_skus[].meter
課金対象。テキストモデルは input_tokens、output_tokens、cache_read_tokens、cache_write_tokens、cache_write_5m_tokens、cache_write_1h_tokens、画像は output_images、動画は output_video を使用します。
pricing_skus[].unit / quantity
料金の単位と数量:テキストは 1,000,000 トークンあたり、画像は 1 枚あたり、動画は 1 秒あたりです。
pricing_skus[].price_usd
USD 建ての Wokey 料金(10 進数の文字列)。
reference_price_usd / savings_pct
テキストモデルのみ:公式の参考価格と、それに対する割引率(パーセント)。
pricing_skus[].constraints
料金が適用される条件。画像サイズの区分や、動画のモード・解像度・長さの範囲など。
time_of_day
時間帯別料金のモデルのみ。current_tier は現在の時間帯(peak または off_peak)、peak_windows_utc はピーク時間帯を UTC で列挙し、tiers は両方の時間帯の料金を示します。pricing_skus は常に現在の時間帯の料金を表示します。
prompt_tiers
入力の長さで料金が変わるモデルのみ。リクエストの入力(キャッシュの読み取りと書き込みを含む)が above_prompt_tokens を超えると、すべての課金項目にその区分の料金が適用されます。
JSON
{
  "object": "list",
  "data": [
    {
      "id": "deepseek-v4.1-flash",
      "name": "DeepSeek-V4.1-Flash",
      "owned_by": "deepseek",
      "providers": ["deepseek", "opencode", "ollama", "volcengine"],
      "object": "model",
      "available": true,
      "currency": "USD",
      "pricing_skus": [
        {
          "sku_id": "deepseek-v4.1-flash:input_tokens",
          "meter": "input_tokens",
          "unit": "token",
          "quantity": 1000000,
          "price_usd": "0.075000",
          "reference_price_usd": "0.150000",
          "savings_pct": "50"
        },
        {
          "sku_id": "deepseek-v4.1-flash:output_tokens",
          "meter": "output_tokens",
          "unit": "token",
          "quantity": 1000000,
          "price_usd": "0.300000",
          "reference_price_usd": "0.600000",
          "savings_pct": "50"
        }
      ]
    }
  ]
}

サンプルではモデルを 1 つだけ残し、一部のフィールドを省略しています。

  • 料金は時間帯や供給状況によって変わることがあるため、このエンドポイントはキャッシュされず、常に現在の料金を返します。

画像・動画モデルlink

cURL
curl 'https://api.wokey.ai/v1/images/models'
curl 'https://api.wokey.ai/v1/videos/models'
GET/v1/images/models

現在呼び出せる画像モデルを返します:対応エンドポイント(生成、編集)、パラメータとその許容値(parameter_schema)、ストリーミングと編集への対応、1 枚あたりの料金(pricing_skus)。 使い方: 画像生成 →

GET/v1/videos/models

販売可能なバリアントが 1 つ以上ある動画モデルを返します:生成モード、解像度、アスペクト比、長さの範囲、マルチモーダル参照の上限、各バリアントの 1 秒あたりの料金(pricing_skus)。 使い方: 動画生成 →