コア
モデル一覧の取得
TokenLabで現在利用可能なモデルの一覧を取得します
モデルカタログは公開されており、APIキーは不要です。各項目には、現在の機能、価格、APIフォーマットの概要が含まれています。詳細が必要な場合は、特定のモデルを取得してください。
APIキーを提供すると、TokenLabはそのキーを検証し、そのキーのモデル権限および有効な配信ポリシーに基づいてカタログをフィルタリングします。verifiedに設定されたキーはTokenLab Verified供給のモデルを一覧表示し、officialに設定されたキーはOfficial供給のモデルを一覧表示します。キーや配信ポリシーが変更された場合は、モデルセレクターを更新してください。リクエストのサポートされている配信オーバーライドは、キーやワークスペースのデフォルトよりも優先されます。
クエリパラメータ
chat、image、video、audio、tts、stt、music、3d、embedding、rerank、decision、またはtranslationでフィルタリングします。
image、video、music、3d、tts、stt、embedding、rerank、decision、またはtranslationなどのタスクに対する現在の推奨事項を返します。
openai、anthropic、google、deepseekなどのモデル作成者でフィルタリングします。
reasoning、tool-use、vision、text-to-imageなどの機能タグでフィルタリングします。モデルのtokenlab.capabilitiesに含まれる値は有効なタグです。モデルの種類でフィルタリングするには、categoryを使用してください。
fullfullは以下に説明する完全なリスト形式を返します。compactはモデル選択用に以下の項目を含む小さなリストを返します:id、provider、category、capabilities、トークン制限、価格概要、status、deliveryAvailability、supported_operations、request_endpoint、およびトップレベルのviewとcount。
レスポンス
listです。id、owned_by、およびtokenlabの概要を持つモデル。tokenlab配下の一般的なリストフィールドは以下の通りです:
tokenlab.aliasestokenlab.capabilitiestokenlab.deliveryAvailability: 設定されたverifiedおよびofficialのサポート(提供されている場合)。フィールドがない場合は不明を意味します。サポートはリアルタイムの可用性を保証するものではありません。tokenlab.pricing: Verified価格。tokenlab.deliveryAvailability.verifiedがfalseの場合、価格フィールドはnullになります。その場合、モデルはOfficial価格で請求されます。tokenlab.official_pricing: Official価格。Official配信のリクエストは、この価格で請求されます。tokenlab.pricing_unittokenlab.max_input_tokensおよびtokenlab.max_output_tokenstokenlab.categorytokenlab.lifecycle、tokenlab.commercial、およびtokenlab.badgestokenlab.request_format_summaryrecommended_forが使用されている場合のtokenlab.agent_preferences
recommended_forが使用されている場合、結果には推奨ステータスと更新時間が含まれることがあります。順序を固定するのではなく、現在のレスポンスを読み取ってください。
エラー
| ステータス | コード | 原因 |
|---|---|---|
400 | invalid_view, invalid_provider, invalid_category, invalid_recommended_for | クエリ値が受け入れられません。メッセージに有効な値が記載されています。categoryとrecommended_forの両方が設定されている場合、それらは一致している必要があります |
401 | invalid_api_key | 無効なAPIキーが送信されました。公開リストを読み取るにはヘッダーを削除してください |
429 | rate_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 APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。
場所: header
クエリパラメータ
公開モデルプロバイダー(openai、anthropic、google、minimaxなど)でフィルタリングします。
reasoning、tool-use、vision、text-to-image などの機能タグでフィルタリングします。モデルの tokenlab.capabilities にある値が有効なタグです。モデルの種類でフィルタリングするには category を使用してください。
モデルカテゴリでフィルタリングします。
指定できる値
- "chat"
- "embedding"
- "translation"
- "image"
- "video"
- "audio"
- "tts"
- "stt"
- "rerank"
- "3d"
- "music"
- "decision"
タスクカテゴリのサポートされている非チャットモデルを並べ替え、推奨エビデンスを含めます。
指定できる値
- "image"
- "video"
- "music"
- "3d"
- "tts"
- "stt"
- "embedding"
- "rerank"
- "translation"
- "decision"
コンパクトなモデル選択フィールドか、完全なOpenAI互換リスト形式かを選択します。
"full"指定できる値
- "compact"
- "full"
レスポンス
application/json
application/json
application/json
application/json
application/json