Guias principais

Integração confiável com TokenLab

Integração confiável com TokenLab

Modelos e custo

Consulte recursos e preços atuais na API ou página do modelo. Compare tarefas equivalentes e informe o modelo em cada solicitação. Não troque de modelo sem avisar: preço, qualidade, ferramentas e contexto podem mudar.

Limite a saída conforme o formato e o modelo e reduza contexto duplicado. O custo de mídia pode depender de quantidade, duração ou resolução; mostre a estimativa disponível antes de confirmar uma geração cara.

Streaming e retries

Streaming mostra o texto antes, mas não reduz o custo dos tokens. Preserve a saída parcial útil após uma desconexão sem marcá-la como resposta completa.

Em 429, respeite Retry-After ou retry_after; use espera progressiva curta para 5xx transitórios. Erros de autenticação, permissão, saldo, validação e contexto exigem correção. Limite tentativas e tempo total sem duplicar os retries do SDK.

Chaves e registros

Guarde chaves no servidor ou em um gerenciador de segredos, nunca no navegador, aplicativo distribuído, repositório público ou logs. Separe desenvolvimento, produção e aplicativos, limite modelos e gastos e revogue chaves expostas.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["TOKENLAB_API_KEY"],
    base_url="https://api.tokenlab.sh/v1",
    timeout=30.0,
    max_retries=0,
)

Registre request_id, task_id, o billing_transaction_id recebido, modelo, endpoint e seu ID de trabalho. Não registre credenciais, prompts privados completos, mídia ou URLs assinadas. O valor final está em Usage ou na API de gerenciamento.

Tarefas assíncronas

Salve o ID e poll_url ao criar uma tarefa assíncrona e consulte até completed ou failed. Uma falha na consulta não significa falha na geração. Após timeout ou atualização, retome a tarefa salva; use chave de idempotência quando o endpoint permitir.

Trabalhos Assíncronos & Polling

Antes do lançamento

Antes do lançamento, verifique o modelo e formato exatos, sucesso e erros comuns, preços atuais, atualizações de página e cliques repetidos.

Nesta página