TokenLab
Get API key
DocumentationAPI ReferenceIntegrations

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, or translation.

recommended_forstringquery

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

providerstringquery

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

tagstringquery

Filter by a tag such as chat, image, video, embedding, or translation.

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 and 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.

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": {},        "capabilities": [          "string"        ],        "providers": [          "string"        ],        "max_input_tokens": 0,        "max_output_tokens": 0,        "category": "string",        "pricing_unit": "string",        "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 public capability tag.

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

API Reference

Previous

Get a Model

Next