Calculadora de Sobrecarga de Saída Estruturada
Entradas
| Número de Campos | 8 |
|---|---|
| Tokens por Campo | 8 |
| Número de Chamadas | 1.000 |
| Preço de Saída (por 1M de tokens) | 3 $ |
| Tokens de Envoltório | 4 |
Calculadora de Sobrecarga de Saída Estruturada
Estime os tokens de saída adicionais e o custo de pedir a um LLM que retorne JSON conforme um esquema — os nomes de campos, marcadores de tipo e a pontuação que envolvem os valores em si.
Entradas
Esquema
Volume e Preços
Tokens de Envoltório
Resultados
Insira um valor para ver os resultados.
Detalhes
Sobrecarga de saída estruturada
Sobrecarga de saída estruturada é a parcela de uma resposta de LLM composta por formatação, e não por conteúdo. Quando se pede a um modelo que retorne JSON conforme a um esquema, ele precisa emitir cada nome de chave, aspa, dois-pontos, vírgula e chave, além dos valores em si. Esses tokens estruturais são gerados e faturados exatamente como qualquer outro token de saída, de modo que uma resposta que carrega alguns poucos valores curtos pode gastar uma grande fração de seus tokens com estrutura. Esta calculadora isola essa sobrecarga fixa e o custo recorrente que ela produz ao longo de um volume de chamadas.
De onde vem a sobrecarga
Cada campo do objeto retornado contribui com uma chave entre aspas, dois-pontos
separando a chave do valor e uma vírgula antes do próximo campo. Um campo chamado
shipping_status é tokenizado em várias partes antes que qualquer valor seja
escrito. Além do custo por campo, toda resposta carrega uma moldura fixa — as
chaves de abertura e fechamento do objeto e qualquer estrutura de esquema que o
provedor injete — contada uma vez, independentemente de quantos campos a seguem.
Como essa moldura e a estrutura por campo não dependem dos valores, a sobrecarga
é constante para um dado esquema e cresce linearmente com o número de chamadas.
A fórmula
Com campos a tokens de estrutura cada e tokens de envoltório, a sobrecarga por chamada é
tcall=f⋅tf+twAo longo de chamadas, a contagem total de tokens estruturais e seu custo a um preço de saída por milhão de tokens são
TC=tcall⋅n=106TpA divisão por converte a cotação por milhão em uma tarifa por token. A saída estruturada é gerada pelo modelo, então a sobrecarga é faturada pela tarifa de saída, que costuma ser a maior entre os dois preços divulgados.
Exemplo resolvido
Considere uma tarefa de extração que retorna um registro de 12 campos, em que cada campo custa cerca de 9 tokens de estrutura e a moldura do objeto adiciona 5 tokens de envoltório. A sobrecarga por chamada é
tcall=12×9+5=113 tokensExecutada ao longo de 40.000 chamadas a um preço de saída de $15 por milhão de tokens, o custo estrutural é
TC=113×40000=4520000 tokens=1064520000×15=$67.80Esses $67,80 não compram informação alguma — pagam apenas pelas chaves, nomes e vírgulas que envolvem os valores extraídos. Nesse volume, encurtar nomes de chave ou descartar campos não usados se traduz diretamente em uma economia recorrente.
Observações e variações
O valor por campo é uma média; nomes de chave longos e descritivos custam mais do que os concisos, e objetos aninhados acrescentam suas próprias chaves e nomes intermediários. O modelo também emite os próprios valores, que esta calculadora exclui — ela mede apenas o piso estrutural que um esquema impõe. Onde a mesma tarefa puder ser atendida por uma representação mais compacta, esse piso cai proporcionalmente.
Aplicação
A sobrecarga de saída estruturada recai sobre o lado da saída da fatura. A contrapartida do lado da entrada — as definições de ferramentas enviadas com cada requisição de chamada de funções — é tratada pela Calculadora de Sobrecarga de Tokens de Chamada de Funções. Para precificar o uso de tokens por chamada subjacente do qual essas sobrecargas derivam, consulte a Calculadora de Custo por Token.
Perguntas frequentes (FAQ)
O que é saída estruturada?
Saída estruturada é um modo em que o modelo é restringido a retornar dados em um formato fixo — na maioria das vezes, JSON conforme a um esquema fornecido — em vez de prosa livre. É usada quando um programa irá analisar a resposta diretamente, como ao extrair campos de um documento ou retornar um registro tipado.
A estrutura é conveniente para o código que a consome, mas é feita de tokens: cada nome de chave, aspa, dois-pontos, vírgula e chave é gerado e faturado junto com os valores.
Como reduzir a sobrecarga do esquema?
Nomes de chave mais curtos custam menos tokens, de modo que um nome de campo compacto reduz o valor por campo em todas as chamadas. Retornar apenas os campos que uma etapa posterior realmente usa evita pagar por dados que ninguém lê. Achatar objetos profundamente aninhados remove chaves e nomes intermediários.
Como a sobrecarga é fixa por resposta, ela pesa mais em chamadas de alto volume e carga pequena, em que a estrutura pode rivalizar com o conteúdo em tamanho.
O modo JSON custa o mesmo que a chamada de funções?
Ambos impõem sobrecarga de tokens, mas em lugares diferentes. O modo JSON ou de saída estruturada adiciona tokens à resposta — o objeto que o modelo escreve de volta. A chamada de funções, além disso, envia as definições das ferramentas na entrada de cada chamada, de modo que sua sobrecarga recai majoritariamente sobre o lado da entrada.
A calculadora de sobrecarga de chamada de funções trata desse custo do lado da entrada; esta calculadora trata do custo do lado da saída do objeto retornado.
Aviso legal
Os valores de tokens são estimativas que dependem do tokenizador do modelo, dos nomes exatos das chaves e de como o esquema se aninha. Os preços divulgados mudam com o tempo e podem não incluir descontos de cache ou de lote. Confirme as tarifas atuais e as contagens exatas de tokens com seu provedor antes de usar um valor para faturamento.