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.