Saltar para o conteúdo principal

​
Visão Geral

A TokenLab utiliza o modelo de preços pay-as-you-go. Você paga apenas pelo que usar, sem assinaturas ou compromissos mínimos.

​
Como Funciona o Faturamento

  1. Adicione créditos à sua conta
  2. Use a API - os custos são deduzidos por requisição
  3. Monitore o uso no seu painel
  4. Recarregue quando seu saldo estiver baixo

​
Modelos de Preços

Preços ao vivo podem mudar conforme provedores, rotas e détails du modèle. Use o Dashboard, a página de modelos, GET /v1/models/:model/pricing e a Pricing API como referência atual.

​
Preços baseados em token

A maioria dos modelos de chat, raciocínio, embedding, rerank e alguns de imagem são cobrados por tokens de entrada, saída, cache ou saída de imagem.
Família de preçoExemplosVerificar preço atual
Chat / Responsesgpt-5.4, claude-sonnet-4-6, gemini-3.5-flash模型页或 Pricing API
嵌入 / reranktext-embedding-3-small, qwen3-vl-rerank模型价格详情
按 token 计费的图像gpt-image-2GET /v1/models/gpt-image-2/pricing
Não copie tabelas estáticas de preço para a lógica de produção. Guarde apenas IDs de modelo no código e revise preços antes do lançamento.

​
Preços por requisição e tarefa

Modelos de imagem, vídeo, música, 3D, áudio e world podem ser cobrados por requisição, imagem, segundo/minuto, tarefa ou uso específico do provedor.
FamíliaExemplos
图像flux-pro, qwen-image-plus
视频veo3.1, seedance-2.0
音乐suno-music
3Dtripo-h3.1
音频tts-1, whisper-1

​
Faturamento de Tarefas Assíncronas (Vídeo/Música/3D e Alguns Modelos de Imagem)

Em geração baseada em tarefas, criar a tarefa pode reservar ou pré-deduzir o custo estimado. A liquidação final só acontece depois que a tarefa assíncrona atinge um estado terminal de sucesso durante o polling ou a finalização.
Para fluxos de geração baseados em tarefas (vídeo, música, 3D e alguns modelos de imagem):
  1. Envie a tarefa. A TokenLab pode aplicar uma pré-dedução ou reserva estimada para verificar saldo e limites de gasto da API Key.
  2. Consulte a poll_url retornada, ou chame GET /v1/tasks/{id}, até que a tarefa alcance um estado terminal.
  3. Quando a tarefa é concluída com sucesso, a liquidação final registra o uso e a resposta da tarefa inclui billing_transaction_id.
  4. Se a criação falhar ou o estado terminal for failed, o valor pendente é reembolsado ou liberado e a solicitação é marcada como não faturável.
Se o dashboard não refletir a liquidação ou o reembolso depois que o estado terminal estiver visível, entre em contato com support@tokenlab.sh. 
# Exemplo: Faturamento de geração de vídeo
response = client.post("/v1/videos/generations", json={
    "model": "veo3.1",
    "prompt": "A sunset over the ocean"
})
# O custo estimado pode ser reservado agora; a cobrança final aparece após sucesso.

poll_url = response.json()["poll_url"]
task_id = response.json()["task_id"]
# Consulte poll_url para verificar o status; billing_transaction_id aparece após a liquidação.

​
IDs de transação de faturamento

Respostas JSON faturáveis, não streaming e compatíveis com OpenAI incluem billing_transaction_id quando a liquidação é concluída antes de finalizar a resposta. O mesmo valor também é exposto no header X-Billing-Transaction-ID, para integrações em navegador e servidor. Rotas de compatibilidade nativa, como Gemini /v1beta, podem expor o valor apenas pelo header para preservar o formato nativo de resposta do provedor. Para tarefas de mídia assíncronas, consulte o poll_url retornado ou GET /v1/tasks/{id}; a resposta da tarefa inclui billing_transaction_id quando a liquidação termina. Respostas streaming podem ser liquidadas depois que o stream já foi enviado; se o header não estiver presente, use os logs de uso do dashboard para conciliação.

​
Contagem de Tokens

Tokens são as unidades básicas do processamento de texto:
  • ~4 caracteres = 1 token (Inglês)
  • ~1-2 caracteres = 1 token (Chinês)
  • 1 imagem = varia conforme o tamanho e detalhes

​
Estimando Tokens

# Estimativa aproximada
def estimate_tokens(text):
    return len(text) / 4  # Aproximado para Inglês

# Contagem real (para modelos OpenAI)
import tiktoken
encoder = tiktoken.encoding_for_model("gpt-4o")
tokens = encoder.encode("Your text here")
print(f"Token count: {len(tokens)}")

​
Acompanhamento de Uso

​
Painel (Dashboard)

Monitore seu uso no Painel:
  • Saldo em tempo real
  • Histórico de uso por modelo
  • Detalhamento de custos
  • Uso de chaves de API

​
Resposta da API

Cada resposta inclui informações de uso: 
{
  "usage": {
    "prompt_tokens": 50,
    "completion_tokens": 100,
    "total_tokens": 150
  }
}

​
Otimização de Custos

Use modelos menores (GPT-4o-mini, Gemini Flash) para tarefas simples.
Armazene em cache as respostas para requisições idênticas repetidas.
Mantenha os prompts concisos, mantendo a clareza.
Limite o comprimento da resposta quando respostas completas não forem necessárias.
O streaming não custa extra, mas melhora o desempenho percebido.

​
Alertas de Saldo Baixo

Configure alertas para quando seu saldo cair:
  1. Vá para Painel → Configurações → Notificações
  2. Defina o valor do seu limite
  3. Receba notificações por e-mail

​
Adicionando Créditos

​
Métodos de Pagamento

  • Stripe (Visa, Mastercard)

​
Passos

  1. Faça login no Painel
  2. Clique em Adicionar Créditos
  3. Selecione o valor e o método de pagamento
  4. Conclua o pagamento
Os créditos são adicionados instantaneamente após a confirmação do pagamento.

​
Limites de Chave de API

Você pode definir limites de gastos em chaves de API individuais:
  1. Vá para Painel → Chaves de API
  2. Clique em uma chave para editar
  3. Defina o Limite de Uso
Quando o limite for atingido, as requisições com essa chave retornarão 402 Payment Required.

​
Faturas

Para contas empresariais, as faturas estão disponíveis:
  1. Vá para Painel → Faturamento
  2. Visualize o histórico de transações
  3. Baixe as faturas como PDF

​
Dúvidas?

Entre em contato com support@tokenlab.sh para consultas de faturamento.