コア

モデル一覧の取得

TokenLabで現在利用可能なモデルの一覧を取得します

GET
/v1/models

モデルカタログは公開されており、APIキーは不要です。各項目には、現在の機能、価格、APIフォーマットの概要が含まれています。詳細が必要な場合は、特定のモデルを取得してください。

APIキーを提供すると、TokenLabはそのキーを検証し、そのキーのモデル権限および有効な配信ポリシーに基づいてカタログをフィルタリングします。verifiedに設定されたキーはTokenLab Verified供給のモデルを一覧表示し、officialに設定されたキーはOfficial供給のモデルを一覧表示します。キーや配信ポリシーが変更された場合は、モデルセレクターを更新してください。リクエストのサポートされている配信オーバーライドは、キーやワークスペースのデフォルトよりも優先されます。

クエリパラメータ

categorystringquery

chat、image、video、audio、tts、stt、music、3d、embedding、rerank、decision、またはtranslationでフィルタリングします。

recommended_forstringquery

image、video、music、3d、tts、stt、embedding、rerank、decision、またはtranslationなどのタスクに対する現在の推奨事項を返します。

providerstringquery

openai、anthropic、google、deepseekなどのモデル作成者でフィルタリングします。

tagstringquery

reasoning、tool-use、vision、text-to-imageなどの機能タグでフィルタリングします。モデルのtokenlab.capabilitiesに含まれる値は有効なタグです。モデルの種類でフィルタリングするには、categoryを使用してください。

viewstringqueryデフォルト: full

fullは以下に説明する完全なリスト形式を返します。compactはモデル選択用に以下の項目を含む小さなリストを返します:id、provider、category、capabilities、トークン制限、価格概要、status、deliveryAvailability、supported_operations、request_endpoint、およびトップレベルのviewとcount。

レスポンス

objectstring
常にlistです。
dataarray
id、owned_by、およびtokenlabの概要を持つモデル。

tokenlab配下の一般的なリストフィールドは以下の通りです:

  • tokenlab.aliases
  • tokenlab.capabilities
  • tokenlab.deliveryAvailability: 設定されたverifiedおよびofficialのサポート(提供されている場合)。フィールドがない場合は不明を意味します。サポートはリアルタイムの可用性を保証するものではありません。
  • tokenlab.pricing: Verified価格。tokenlab.deliveryAvailability.verifiedがfalseの場合、価格フィールドはnullになります。その場合、モデルはOfficial価格で請求されます。
  • tokenlab.official_pricing: Official価格。Official配信のリクエストは、この価格で請求されます。
  • tokenlab.pricing_unit
  • tokenlab.max_input_tokens および tokenlab.max_output_tokens
  • tokenlab.category
  • tokenlab.lifecycle、tokenlab.commercial、および tokenlab.badges
  • tokenlab.request_format_summary
  • recommended_forが使用されている場合の tokenlab.agent_preferences

recommended_forが使用されている場合、結果には推奨ステータスと更新時間が含まれることがあります。順序を固定するのではなく、現在のレスポンスを読み取ってください。

エラー

ステータスコード原因
400invalid_view, invalid_provider, invalid_category, invalid_recommended_forクエリ値が受け入れられません。メッセージに有効な値が記載されています。categoryとrecommended_forの両方が設定されている場合、それらは一致している必要があります
401invalid_api_key無効なAPIキーが送信されました。公開リストを読み取るにはヘッダーを削除してください
429rate_limit_exceeded公開カタログへのリクエストが多すぎます。レスポンスをキャッシュし、Retry-Afterの後に再試行してください

例

curl "https://api.tokenlab.sh/v1/models?category=video"
{
  "object": "list",
  "data": [
    {
      "id": "veo3.1",
      "object": "model",
      "owned_by": "google",
      "tokenlab": {
        "category": "video",
        "capabilities": ["text-to-video", "image-to-video"]
      }
    }
  ]
}

詳細については、モデルの取得を参照してください。

curl -X GET "https://example.com/v1/models"
{  "object": "list",  "data": [    {      "id": "string",      "object": "model",      "created": 0,      "owned_by": "string",      "tokenlab": {        "aliases": [          "string"        ],        "deliveryAvailability": {          "verified": true,          "official": true,          "operations": {            "property1": {              "verified": true,              "official": true            },            "property2": {              "verified": true,              "official": true            }          }        },        "pricing": {          "input_per_1m": "string",          "output_per_1m": "string",          "per_request": "string",          "is_lock_price": true,          "currency": "USD"        },        "official_pricing": {          "input_per_1m": "string",          "output_per_1m": "string",          "per_request": "string",          "is_lock_price": true,          "currency": "USD"        },        "capabilities": [          "string"        ],        "providers": [          "string"        ],        "max_input_tokens": 0,        "max_output_tokens": 0,        "category": "string",        "pricing_unit": "string",        "cache_pricing": {},        "official_cache_pricing": {},        "has_complex_pricing": true,        "pricing_summary": {},        "agent_preferences": {},        "lifecycle": {          "stage": "active",          "reason": "string",          "replacement_model": "string",          "released_at": "2019-08-24T14:15:22Z",          "deprecated_at": "2019-08-24T14:15:22Z",          "retired_at": "2019-08-24T14:15:22Z",          "sunset_at": "2019-08-24T14:15:22Z",          "latest": true,          "latest_source": "auto",          "latest_window_days": 0        },        "commercial": {          "user_charge_policy": "paid",          "free_reason": "platform",          "free_until": "2019-08-24T14:15:22Z"        },        "badges": [          {            "key": "free",            "tone": "green",            "priority": 0,            "tooltip": {              "key": "string",              "values": {                "property1": "string",                "property2": "string"              }            }          }        ],        "request_format_summary": {          "public_operations": [            "string"          ],          "request_endpoint": "string",          "request_endpoint_by_operation": {            "property1": "string",            "property2": "string"          }        }      }    }  ]}

認証

BearerAuth
AuthorizationBearer <token>

APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。

場所: header

クエリパラメータ

provider?string

公開モデルプロバイダー(openai、anthropic、google、minimaxなど)でフィルタリングします。

tag?string

reasoning、tool-use、vision、text-to-image などの機能タグでフィルタリングします。モデルの tokenlab.capabilities にある値が有効なタグです。モデルの種類でフィルタリングするには category を使用してください。

category?string

モデルカテゴリでフィルタリングします。

指定できる値

  • "chat"
  • "embedding"
  • "translation"
  • "image"
  • "video"
  • "audio"
  • "tts"
  • "stt"
  • "rerank"
  • "3d"
  • "music"
  • "decision"
recommended_for?string

タスクカテゴリのサポートされている非チャットモデルを並べ替え、推奨エビデンスを含めます。

指定できる値

  • "image"
  • "video"
  • "music"
  • "3d"
  • "tts"
  • "stt"
  • "embedding"
  • "rerank"
  • "translation"
  • "decision"
view?string

コンパクトなモデル選択フィールドか、完全なOpenAI互換リスト形式かを選択します。

デフォルト"full"

指定できる値

  • "compact"
  • "full"

レスポンス

application/json

application/json

application/json

application/json

application/json