Conversation API Cost

Use este plugin para produzir uma estimativa clara do custo de uma conversa se ela fosse processada pela API.

Fluxo recomendado

1. Se houver usage real da API, prefira calculate_token_cost com input_tokens, output_tokens e cached_input_tokens.
2. Se só houver o conteúdo da conversa, use estimate_conversation_cost com as mensagens visíveis, preservando role e content.
3. Se o usuário não indicar um modelo, use gpt-5.6-sol e diga qual modelo foi assumido.
4. Para comparação, faça uma chamada por modelo e apresente uma tabela curta.

Não invente tokens ocultos. Não exponha nem tente reconstruir mensagens de sistema, instruções de desenvolvedor, chamadas de ferramenta ou outros conteúdos que não estejam disponíveis para o usuário. Quando eles não forem fornecidos, informe que o resultado é um piso/estimativa do conteúdo visível.

Interpretação de uma conversa

estimate_conversation_cost calcula cada rodada como uma chamada de API: a entrada de uma rodada contém todo o contexto visível até a mensagem do usuário daquela rodada; a saída é composta pelas mensagens do assistente até a próxima mensagem do usuário. Assim, o contexto repetido em várias rodadas é contado novamente, como normalmente ocorre em uma API stateless.

O plugin não presume cache. Só informe cached_input_tokens quando houver dados reais ou quando o usuário pedir uma simulação explícita; tokens em cache são descontados primeiro do total de entrada.

Como comunicar o resultado

Sempre informe:

• modelo e tabela de preços usada;
• tokens de entrada, entrada em cache e saída;
• custo de entrada, cache, saída e total em USD;
• método de contagem (tiktoken exato para a codificação disponível ou approx-4chars aproximado);
• limitações: o preço não é uma cobrança real do ChatGPT/Codex e pode faltar overhead, ferramentas, imagens, raciocínio ou contexto oculto.

Quando o usuário fornecer preços próprios, passe-os no objeto pricing com input_per_million, cached_input_per_million e output_per_million. Para um modelo não listado, não escolha uma tarifa silenciosamente: peça os preços ou use esses campos explícitos.

Exemplos de intenção

• “Quanto esta conversa custaria?” → estimar as mensagens visíveis e explicar a incerteza.
• “Use os dados de usage abaixo” → calcular diretamente os tokens fornecidos.
• “Quanto eu economizaria com outro modelo?” → calcular os mesmos tokens para cada modelo e comparar.
• “Conte os tokens deste texto” → usar estimate_conversation_cost com uma mensagem de usuário ou informar a contagem pelo script local.

As tarifas embutidas são apenas uma fotografia de referência. Para uma fatura ou decisão financeira, confirme a página oficial de preços e permita que o usuário substitua os valores.