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.

Parâmetros de Consulta

categorystringquery

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

recommended_forstringquery

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

providerstringquery

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

tagstringquery

Filtre por uma tag como chat, image, video, embedding ou translation.

Resposta

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

Campos comuns da lista sob tokenlab incluem:

  • tokenlab.aliases
  • tokenlab.capabilities
  • tokenlab.pricing e 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 é utilizado

Quando recommended_for é utilizado, 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.

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": {},        "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"          }        }      }    }  ]}

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

Filtrar por uma tag de capacidade pública.

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