TokenLab

Core

List Models

List models currently available on TokenLab

GET
/v1/models

The model catalog is public and does not require an API key. Each item includes a summary of current capabilities, prices, and API formats. Retrieve one model when you need full details.

When you provide an API key, TokenLab validates it and filters the catalog for its model permissions and effective delivery policy. A key set to verified lists models with TokenLab Verified supply; official lists models with Official supply. Refresh your model selector when the key or delivery policy changes. The request's supported delivery override takes precedence over the key and workspace defaults.

Query Parameters

categorystringquery

Filter by chat, image, video, audio, tts, stt, music, 3d, embedding, rerank, decision, or translation.

recommended_forstringquery

Return current recommendations for a task such as image, video, music, 3d, tts, stt, embedding, rerank, decision, or translation.

providerstringquery

Filter by model maker, such as openai, anthropic, google, or deepseek.

tagstringquery

Filter by a capability tag such as reasoning, tool-use, vision, or text-to-image. The values in a model's tokenlab.capabilities are valid tags. To filter by kind of model, use category.

viewstringquerydefault: full

full returns the complete list shape described below. compact returns a smaller list for model selection: id, provider, category, capabilities, token limits, a price summary, status, deliveryAvailability, supported_operations, and request_endpoint, plus view and count at the top level.

Response

objectstring
Always list.
dataarray
Models with id, owned_by, and a tokenlab summary.

Common list fields under tokenlab include:

  • tokenlab.aliases
  • tokenlab.capabilities
  • tokenlab.deliveryAvailability: configured verified and official support, when provided. A missing field means unknown; support does not guarantee real-time availability.
  • tokenlab.pricing: the Verified price. Its price fields are null when tokenlab.deliveryAvailability.verified is false; such a model is billed at the Official price.
  • tokenlab.official_pricing: the Official price. Requests that Official delivers are billed at this price.
  • tokenlab.pricing_unit
  • tokenlab.max_input_tokens and tokenlab.max_output_tokens
  • tokenlab.category
  • tokenlab.lifecycle, tokenlab.commercial, and tokenlab.badges
  • tokenlab.request_format_summary
  • tokenlab.agent_preferences when recommended_for is used

When recommended_for is used, results may also include recommendation status and an update time. Read the current response instead of pinning the order.

Errors

StatusCodeCause
400invalid_view, invalid_provider, invalid_category, invalid_recommended_forA query value is not accepted. The message lists the valid values. category and recommended_for must match when both are set
401invalid_api_keyYou sent an API key that is not valid. Remove the header to read the public list
429rate_limit_exceededToo many requests to the public catalog. Cache the response and retry after Retry-After

Example

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"]
      }
    }
  ]
}

See Get a Model for complete details.

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"          }        }      }    }  ]}

Authorization

BearerAuth
AuthorizationBearer <token>

API Key authentication. Create or manage API keys in Dashboard > API > API Keys.

In: header

Query Parameters

provider?string

Filter by public model provider, for example openai, anthropic, google, or minimax.

tag?string

Filter by a capability tag such as reasoning, tool-use, vision, or text-to-image. The values in a model's tokenlab.capabilities are valid tags. To filter by kind of model, use category.

category?string

Filter by model category.

Value in

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

Sort supported non-chat models for a task category and include recommendation evidence.

Value in

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

Choose compact model-selection fields or the full OpenAI-compatible list shape.

default"full"

Value in

  • "compact"
  • "full"

Response

application/json

application/json

application/json

application/json

application/json