Essencial

Listar Modelos

Listar modelos atualmente disponíveis no TokenLab

GET
/v1/models

O catálogo de modelos é público e não requer uma API key. Cada item inclui um resumo das capacidades atuais, preços e formatos de API. Recupere um modelo específico quando precisar de detalhes completos.

Quando você fornece uma API key, o TokenLab a valida e filtra o catálogo de acordo com as permissões do modelo e a política de entrega efetiva. Uma chave definida como verified lista modelos com fornecimento TokenLab Verified; official lista modelos com fornecimento Official. Atualize seu seletor de modelos quando a chave ou a política de entrega mudar. A substituição de entrega suportada da solicitação tem precedência sobre os padrões da chave e do workspace.

Parâmetros de Consulta

categorystringquery

Filtre por chat, image, video, audio, tts, stt, music, 3d, embedding, rerank, decision ou translation.

recommended_forstringquery

Retorne recomendações atuais para uma tarefa como image, video, music, 3d, tts, stt, embedding, rerank, decision ou translation.

providerstringquery

Filtre pelo fabricante do modelo, como openai, anthropic, google ou deepseek.

tagstringquery

Filtre por uma tag de capacidade como reasoning, tool-use, vision ou text-to-image. Os valores em tokenlab.capabilities de um modelo são tags válidas. Para filtrar pelo tipo de modelo, use category.

viewstringquerypadrão: full

full retorna a lista completa descrita abaixo. compact retorna uma lista menor para seleção de modelos: id, provider, category, capabilities, limites de tokens, um resumo de preços, status, deliveryAvailability, supported_operations e request_endpoint, além de view e count no nível superior.

Resposta

objectstring
Sempre list.
dataarray
Modelos com id, owned_by e um resumo tokenlab.

Campos comuns da lista em tokenlab incluem:

  • tokenlab.aliases
  • tokenlab.capabilities
  • tokenlab.deliveryAvailability: suporte configurado para verified e official, quando fornecido. Um campo ausente significa desconhecido; o suporte não garante disponibilidade em tempo real.
  • tokenlab.pricing: o preço Verified. Seus campos de preço são null quando tokenlab.deliveryAvailability.verified é false; tal modelo é cobrado pelo preço Official.
  • tokenlab.official_pricing: o preço Official. Solicitações que a Official entrega são cobradas por este preço.
  • tokenlab.pricing_unit
  • tokenlab.max_input_tokens e tokenlab.max_output_tokens
  • tokenlab.category
  • tokenlab.lifecycle, tokenlab.commercial e tokenlab.badges
  • tokenlab.request_format_summary
  • tokenlab.agent_preferences quando recommended_for é usado

Quando recommended_for é usado, os resultados também podem incluir o status da recomendação e um horário de atualização. Leia a resposta atual em vez de fixar a ordem.

Erros

StatusCódigoCausa
400invalid_view, invalid_provider, invalid_category, invalid_recommended_forUm valor de consulta não é aceito. A mensagem lista os valores válidos. category e recommended_for devem corresponder quando ambos são definidos
401invalid_api_keyVocê enviou uma API key que não é válida. Remova o cabeçalho para ler a lista pública
429rate_limit_exceededMuitas solicitações para o catálogo público. Armazene a resposta em cache e tente novamente após Retry-After

Exemplo

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

Veja Obter um Modelo para detalhes completos.

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

Autorização

BearerAuth
AuthorizationBearer <token>

Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.

Local: header

Parâmetros de consulta

provider?string

Filtrar por provedor de modelo público, por exemplo, openai, anthropic, google ou minimax.

tag?string

Filtre por uma tag de capacidade como reasoning, tool-use, vision ou text-to-image. Os valores em tokenlab.capabilities de um modelo são tags válidas. Para filtrar pelo tipo de modelo, use category.

category?string

Filtrar por categoria de modelo.

Valores permitidos

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

Ordenar modelos suportados que não são de chat para uma categoria de tarefa e incluir evidências de recomendação.

Valores permitidos

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

Escolha campos de seleção de modelo compactos ou o formato de lista completo compatível com OpenAI.

padrão"full"

Valores permitidos

  • "compact"
  • "full"

Resposta

application/json

application/json

application/json

application/json

application/json