TokenLab
Obtener clave API
DocumentaciónReferencia APIIntegraciones

Base

Obtener un modelo

Obtenga las capacidades, precios y formatos de API de un modelo

GET
/v1/models/{model}

Parámetro de ruta

modelstringpathobligatorio

ID del modelo, como gpt-5.6-terra o claude-sonnet-4-6.

Respuesta

idstring
ID del modelo.
objectstring
Siempre model.
owned_bystring
Creador del modelo.
tokenlabobject

Información del modelo TokenLab, incluyendo capacidades, precios, unidades de facturación, límites de contexto, formatos de API aceptados, operaciones y estado del ciclo de vida.

Los campos comunes de tokenlab incluyen:

  • capabilities: capacidades de texto, imagen, video, audio y otras.
  • pricing: precios públicos actuales.
  • max_input_tokens y max_output_tokens: límites de contexto y de salida.
  • accepted_request_formats: formatos de API admitidos.
  • supported_operations: operaciones como texto a imagen o imagen a video.
  • lifecycle: disponibilidad, fecha de lanzamiento, fecha de obsolescencia o modelo de reemplazo.

Algunos modelos de medios también incluyen un estado de recomendación y tiempo de actualización. Las recomendaciones pueden cambiar según la disponibilidad y el rendimiento, por lo que no debe codificar su orden de forma rígida (hard-code).

Ejemplo

curl "https://api.tokenlab.sh/v1/models/gpt-5.6-terra"
{
  "id": "gpt-5.6-terra",
  "object": "model",
  "owned_by": "openai",
  "tokenlab": {
    "category": "chat",
    "capabilities": ["coding", "json-mode", "prompt-cache", "reasoning", "tool-use", "vision"],
    "accepted_request_formats": ["openai_chat_completions", "openai_responses"]
  }
}

Un modelo desconocido devuelve 404 model_not_found.

curl -X GET "https://example.com/v1/models/string"
{  "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,    "supported_operations": [      "string"    ],    "pricing_summary": {},    "pricing_provenance": {},    "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"      ],      "supported_parameters": [        "string"      ],      "feature_flags": {        "property1": true,        "property2": true      },      "output_formats": [        "string"      ],      "service_limits": {        "online_rpm": 0,        "concurrency": 0,        "offline_inference": true,        "offline_tpd": "string",        "prompt_max_characters": 0      },      "required_selectors": [        "string"      ],      "optional_selectors": [        "string"      ],      "resolutions": [        "string"      ],      "resolutions_label": "string",      "durations": [        "string"      ],      "durations_label": "string",      "aspect_ratios": [        "string"      ],      "aspect_ratios_label": "string",      "request_endpoint": "string",      "status_mode": "string",      "request_shape_mode": "string",      "recommended_request_summary": {},      "request_endpoint_by_operation": {        "property1": "string",        "property2": "string"      },      "operation_constraints": [        {          "operation": "string",          "request_endpoint": "string",          "request_shape_mode": "string",          "status_mode": "string",          "supported_parameters": [            "string"          ],          "required_selectors": [            "string"          ],          "optional_selectors": [            "string"          ],          "documented_inputs": [            "string"          ],          "allowed_resolutions": [            "string"          ],          "allowed_durations": [            "string"          ],          "allowed_aspect_ratios": [            "string"          ],          "notes": [            "string"          ],          "parameter_options": {            "property1": [              "string"            ],            "property2": [              "string"            ]          },          "parameter_value_constraints": {            "property1": {              "enum": [                "string"              ],              "enumCaseInsensitive": true,              "maxItems": 0,              "maxInteger": 0,              "when": {                "parameter": "string",                "equals": "string"              }            },            "property2": {              "enum": [                "string"              ],              "enumCaseInsensitive": true,              "maxItems": 0,              "maxInteger": 0,              "when": {                "parameter": "string",                "equals": "string"              }            }          }        }      ]    },    "request_format_details": {      "public_operations": [        "string"      ],      "supported_parameters": [        "string"      ],      "feature_flags": {        "property1": true,        "property2": true      },      "output_formats": [        "string"      ],      "service_limits": {        "online_rpm": 0,        "concurrency": 0,        "offline_inference": true,        "offline_tpd": "string",        "prompt_max_characters": 0      },      "required_selectors": [        "string"      ],      "optional_selectors": [        "string"      ],      "resolutions": [        "string"      ],      "resolutions_label": "string",      "durations": [        "string"      ],      "durations_label": "string",      "aspect_ratios": [        "string"      ],      "aspect_ratios_label": "string",      "request_endpoint": "string",      "status_mode": "string",      "request_shape_mode": "string",      "recommended_request_summary": {},      "request_endpoint_by_operation": {        "property1": "string",        "property2": "string"      },      "operation_constraints": [        {          "operation": "string",          "request_endpoint": "string",          "request_shape_mode": "string",          "status_mode": "string",          "supported_parameters": [            "string"          ],          "required_selectors": [            "string"          ],          "optional_selectors": [            "string"          ],          "documented_inputs": [            "string"          ],          "allowed_resolutions": [            "string"          ],          "allowed_durations": [            "string"          ],          "allowed_aspect_ratios": [            "string"          ],          "notes": [            "string"          ],          "parameter_options": {            "property1": [              "string"            ],            "property2": [              "string"            ]          },          "parameter_value_constraints": {            "property1": {              "enum": [                "string"              ],              "enumCaseInsensitive": true,              "maxItems": 0,              "maxInteger": 0,              "when": {                "parameter": "string",                "equals": "string"              }            },            "property2": {              "enum": [                "string"              ],              "enumCaseInsensitive": true,              "maxItems": 0,              "maxInteger": 0,              "when": {                "parameter": "string",                "equals": "string"              }            }          }        }      ],      "documented_inputs": [        "string"      ],      "documented_outputs": [        "string"      ],      "fallback_status_endpoints": [        "string"      ],      "notes": [        "string"      ],      "recommended_request": {}    },    "accepted_request_formats": [      "openai_chat_completions"    ]  }}

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 ruta

model*string

El ID del modelo

Respuesta

application/json

application/json

application/json

application/json

Listar modelos

Anterior

Obtener precios

Siguiente