Base
Listar modelos
Listar los modelos disponibles actualmente en TokenLab
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.
Cuando proporciona una API key, TokenLab la valida y filtra el catálogo según sus permisos de modelo y la política de entrega efectiva. Una clave configurada como verified lista modelos con suministro TokenLab Verified; official lista modelos con suministro Official. Actualice su selector de modelos cuando cambie la clave o la política de entrega. La anulación de entrega admitida de la solicitud tiene prioridad sobre los valores predeterminados de la clave y del espacio de trabajo.
Parámetros de consulta
Filtrar por chat, image, video, audio, tts, stt, music, 3d, embedding, rerank, decision o translation.
Devolver las recomendaciones actuales para una tarea como image, video, music, 3d, tts, stt, embedding, rerank, decision o translation.
Filtrar por fabricante del modelo, como openai, anthropic, google o deepseek.
Filtrar por una etiqueta de capacidad como reasoning, tool-use, vision o text-to-image. Los valores en tokenlab.capabilities de un modelo son etiquetas válidas. Para filtrar por tipo de modelo, utilice category.
fullfull devuelve la lista completa con la estructura descrita a continuación. compact devuelve una lista más pequeña para la selección de modelos: id, provider, category, capabilities, límites de tokens, un resumen de precios, status, deliveryAvailability, supported_operations y request_endpoint, además de view y count en el nivel superior.
Respuesta
list.id, owned_by y un resumen tokenlab.Los campos de lista comunes bajo tokenlab incluyen:
tokenlab.aliasestokenlab.capabilitiestokenlab.deliveryAvailability: soporte configurado paraverifiedyofficial, cuando se proporciona. Un campo faltante significa desconocido; el soporte no garantiza la disponibilidad en tiempo real.tokenlab.pricing: el precio Verified. Sus campos de precio sonnullcuandotokenlab.deliveryAvailability.verifiedesfalse; dicho modelo se factura al precio Official.tokenlab.official_pricing: el precio Official. Las solicitudes que entrega Official se facturan a este precio.tokenlab.pricing_unittokenlab.max_input_tokensytokenlab.max_output_tokenstokenlab.categorytokenlab.lifecycle,tokenlab.commercialytokenlab.badgestokenlab.request_format_summarytokenlab.agent_preferencescuando se utilizarecommended_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.
Errores
| Estado | Código | Causa |
|---|---|---|
400 | invalid_view, invalid_provider, invalid_category, invalid_recommended_for | Un valor de consulta no es aceptado. El mensaje lista los valores válidos. category y recommended_for deben coincidir cuando ambos están configurados |
401 | invalid_api_key | Envió una API key que no es válida. Elimine el encabezado para leer la lista pública |
429 | rate_limit_exceeded | Demasiadas solicitudes al catálogo público. Almacene la respuesta en caché y vuelva a intentarlo después de Retry-After |
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": { "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" } } } } ]}Autorización
BearerAuth Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.
Ubicación: header
Parámetros de consulta
Filtrar por proveedor de modelo público, por ejemplo, openai, anthropic, google o minimax.
Filtre por una etiqueta de capacidad como reasoning, tool-use, vision o text-to-image. Los valores en tokenlab.capabilities de un modelo son etiquetas válidas. Para filtrar por tipo de modelo, utilice category.
Filtrar por categoría de modelo.
Valores permitidos
- "chat"
- "embedding"
- "translation"
- "image"
- "video"
- "audio"
- "tts"
- "stt"
- "rerank"
- "3d"
- "music"
- "decision"
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"
- "decision"
Elegir campos de selección de modelo compactos o la estructura de lista completa compatible con OpenAI.
"full"Valores permitidos
- "compact"
- "full"
Respuesta
application/json
application/json
application/json
application/json
application/json