Essencial
Listar Modelos
Listar modelos atualmente disponíveis no TokenLab
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
Filtre por chat, image, video, audio, tts, stt, music, 3d, embedding, rerank, decision ou translation.
Retorne recomendações atuais para uma tarefa como image, video, music, 3d, tts, stt, embedding, rerank, decision ou translation.
Filtre pelo fabricante do modelo, como openai, anthropic, google ou deepseek.
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.
fullfull 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
list.id, owned_by e um resumo tokenlab.Campos comuns da lista em tokenlab incluem:
tokenlab.aliasestokenlab.capabilitiestokenlab.deliveryAvailability: suporte configurado paraverifiedeofficial, 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ãonullquandotokenlab.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_unittokenlab.max_input_tokensetokenlab.max_output_tokenstokenlab.categorytokenlab.lifecycle,tokenlab.commercialetokenlab.badgestokenlab.request_format_summarytokenlab.agent_preferencesquandorecommended_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
| Status | Código | Causa |
|---|---|---|
400 | invalid_view, invalid_provider, invalid_category, invalid_recommended_for | Um valor de consulta não é aceito. A mensagem lista os valores válidos. category e recommended_for devem corresponder quando ambos são definidos |
401 | invalid_api_key | Você enviou uma API key que não é válida. Remova o cabeçalho para ler a lista pública |
429 | rate_limit_exceeded | Muitas 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 Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.
Local: header
Parâmetros de consulta
Filtrar por provedor de modelo público, por exemplo, openai, anthropic, google ou minimax.
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.
Filtrar por categoria de modelo.
Valores permitidos
- "chat"
- "embedding"
- "translation"
- "image"
- "video"
- "audio"
- "tts"
- "stt"
- "rerank"
- "3d"
- "music"
- "decision"
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"
Escolha campos de seleção de modelo compactos ou o formato de lista completo compatível com OpenAI.
"full"Valores permitidos
- "compact"
- "full"
Resposta
application/json
application/json
application/json
application/json
application/json