Essencial

Obter Preços

Obter informações de preços para modelos

GET
/v1/pricing

Este endpoint público não requer uma API key.

Visão Geral

Retorna os preços públicos atuais dos modelos. O exemplo de resposta abaixo mostra a estrutura; os preços mudam, portanto, leia a resposta em tempo real.

Para os níveis de preço de um modelo específico, use Obter Preços do Modelo.

Parâmetros de Consulta

providerstringquery

Filtro opcional do fabricante do modelo, como openai, anthropic ou google. Um valor desconhecido retorna 400 invalid_provider.

tagstringquery

Filtro opcional de tag de capacidade, como reasoning, tool-use, vision ou text-to-image. Os valores presentes em capabilities de um modelo são tags válidas. Uma tag que nenhum modelo possui retorna um array data vazio.

Resposta

objectstring

Sempre pricing.

updated_atstring

Timestamp ISO de quando os preços públicos atuais foram publicados.

currencystring

Sempre USD.

dataarray

Array de entradas de preços. Cada item inclui model, provider, is_lock_price, capabilities, aliases e os campos de resumo de preços escalares ou estruturados públicos retornados pelo esquema interativo acima.

Requisição

curl "https://api.tokenlab.sh/v1/pricing?provider=openai&tag=reasoning"

Resposta

Response
{
  "object": "pricing",
  "updated_at": "2026-11-01T06:30:51.988Z",
  "currency": "USD",
  "data": [
    {
      "model": "gpt-5.5",
      "provider": "openai",
      "is_lock_price": false,
      "capabilities": ["coding", "json-mode", "prompt-cache", "reasoning", "tool-use", "vision"],
      "aliases": ["gpt-5-5"],
      "deliveryAvailability": { "verified": true, "official": true },
      "input_per_1m_tokens": "3.5",
      "output_per_1m_tokens": "21",
      "official_input_per_1m_tokens": "5",
      "official_output_per_1m_tokens": "30",
      "has_complex_pricing": true,
      "supported_operations": []
    },
    {
      "model": "allam-2-7b",
      "provider": "sdaia",
      "is_lock_price": false,
      "capabilities": [],
      "aliases": [],
      "deliveryAvailability": { "verified": false, "official": true },
      "official_input_per_1m_tokens": "0.05",
      "official_output_per_1m_tokens": "0.08",
      "has_complex_pricing": false,
      "supported_operations": []
    }
  ]
}

input_per_1m_tokens, output_per_1m_tokens e lock_price_per_request são preços Verificados. Eles são omitidos quando deliveryAvailability.verified é false; tal modelo é cobrado pelo seu preço Oficial (official_input_per_1m_tokens, official_output_per_1m_tokens ou official_lock_price_per_request). Entradas de preços complexos também podem incluir has_complex_pricing, supported_operations e pricing_summary.

Interfaces relacionadas

Obter Preços do Modelo retorna os preços de um modelo. Os detalhes do modelo permanecem a fonte para campos de solicitação e operações suportadas.

Parâmetros de consulta

provider?string

Filtra pelo criador do modelo, por exemplo openai, anthropic, google ou deepseek.

tag?string

Filtra por uma tag de capacidade como reasoning, tool-use, vision ou text-to-image. Os valores em capabilities de um modelo são tags válidas.

Resposta

application/json

application/json

application/json