Essencial

Obter um Modelo

Obtenha as capacidades, preços e formatos de API de um modelo

GET
/v1/models/{model}

Parâmetro de Caminho

modelstringpathobrigatório

ID do modelo, como gpt-5.6-terra ou claude-sonnet-4-6.

Resposta

idstring
ID do modelo.
objectstring
Sempre model.
owned_bystring
Criador do modelo.
tokenlabobject

Informações do modelo TokenLab, incluindo capacidades, preços, unidades de cobrança, limites de contexto, formatos de API aceitos, operações e status do ciclo de vida.

Campos comuns de tokenlab incluem:

  • capabilities: texto, imagem, vídeo, áudio e outras capacidades.
  • pricing: preços públicos atuais.
  • max_input_tokens e max_output_tokens: limites de contexto e de saída.
  • accepted_request_formats: formatos de API suportados.
  • supported_operations: operações como texto-para-imagem ou imagem-para-vídeo.
  • lifecycle: disponibilidade, data de lançamento, data de descontinuação ou modelo de substituição.

Alguns modelos de mídia também incluem um status de recomendação e horário de atualização. As recomendações podem mudar com a disponibilidade e o desempenho, portanto, não codifique (hard-code) a ordem delas.

Exemplo

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

Um modelo desconhecido retorna 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"    ]  }}

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 caminho

model*string

O ID do modelo

Resposta

application/json

application/json

application/json

application/json