Base

Listar modelos

Listar los modelos disponibles actualmente en TokenLab

GET
/v1/models

El catálogo de modelos es público y no requiere una API key. Cada elemento incluye un resumen de las capacidades actuales, precios y formatos de API. Obtenga un modelo específico cuando necesite detalles completos.

Parámetros de consulta

categorystringquery

Filtrar por chat, image, video, audio, tts, stt, music, 3d, embedding, rerank o translation.

recommended_forstringquery

Devolver las recomendaciones actuales para una tarea como image, video, music, 3d, tts, stt, embedding, rerank o translation.

providerstringquery

Filtrar por el creador del modelo, como openai, anthropic, google o deepseek.

tagstringquery

Filtrar por una etiqueta como chat, image, video, embedding o translation.

Respuesta

objectstring
Siempre list.
dataarray
Modelos con id, owned_by y un resumen de tokenlab.

Los campos de lista comunes bajo tokenlab incluyen:

  • tokenlab.aliases
  • tokenlab.capabilities
  • tokenlab.pricing y tokenlab.pricing_unit
  • tokenlab.max_input_tokens y tokenlab.max_output_tokens
  • tokenlab.category
  • tokenlab.lifecycle, tokenlab.commercial y tokenlab.badges
  • tokenlab.request_format_summary
  • tokenlab.agent_preferences cuando se utiliza recommended_for

Cuando se utiliza recommended_for, los resultados también pueden incluir el estado de la recomendación y una hora de actualización. Lea la respuesta actual en lugar de fijar el orden.

Ejemplo

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

Consulte Obtener un modelo para obtener detalles 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"          }        }      }    }  ]}

Autorización

BearerAuth
AuthorizationBearer <token>

Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.

Ubicación: header

Parámetros de consulta

provider?string

Filtrar por proveedor de modelo público, por ejemplo, openai, anthropic, google o minimax.

tag?string

Filtrar por una etiqueta de capacidad pública.

category?string

Filtrar por categoría de modelo.

Valores permitidos

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

Ordenar modelos compatibles que no son de chat para una categoría de tarea e incluir evidencia de recomendación.

Valores permitidos

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

Elegir campos de selección de modelo compactos o la estructura de lista completa compatible con OpenAI.

predeterminado"full"

Valores permitidos

  • "compact"
  • "full"

Respuesta

application/json

application/json

application/json

application/json

application/json