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.

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

categorystringquery

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

recommended_forstringquery

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

providerstringquery

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

tagstringquery

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.

viewstringquerypredeterminado: full

full 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

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

Los campos de lista comunes bajo tokenlab incluyen:

  • tokenlab.aliases
  • tokenlab.capabilities
  • tokenlab.deliveryAvailability: soporte configurado para verified y official, 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 son null cuando tokenlab.deliveryAvailability.verified es false; 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_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.

Errores

EstadoCódigoCausa
400invalid_view, invalid_provider, invalid_category, invalid_recommended_forUn valor de consulta no es aceptado. El mensaje lista los valores válidos. category y recommended_for deben coincidir cuando ambos están configurados
401invalid_api_keyEnvió una API key que no es válida. Elimine el encabezado para leer la lista pública
429rate_limit_exceededDemasiadas 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
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

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.

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