Skip to main content
Uma boa observabilidade do TokenLab começa com identificadores públicos. Seus logs devem ajudá-lo a responder “o que o usuário solicitou, qual tarefa pública o TokenLab criou e como foi cobrado?” sem expor detalhes sensíveis do provedor ou dados sensíveis do usuário.

​
Identificadores Públicos a Capturar

Não armazene IDs de tarefas do provedor, URLs do provedor, identificadores do provedor, chaves Redis ou metadados sensíveis de execução como registros visíveis ao cliente.

​
O Que Registrar

Registre o suficiente para diagnosticar a solicitação sem vazar segredos:
  • Endpoint, método HTTP, modelo, código de status, timestamp e latência.
  • Identificadores públicos: request_id, task_id, poll_url e billing_transaction_id quando presentes.
  • Forma da solicitação sanitizada: quais campos estavam presentes, não o prompt completo ou conteúdo de mídia privada.
  • Respostas de status assíncronas terminais, incluindo campos de erro públicos.
  • Contagem de tentativas do cliente e se a tentativa criou uma nova tarefa ou retomou uma existente.
Sempre redija Authorization, chaves de API, tokens de gerenciamento, URLs assinadas, URLs de mídia privada, prompts completos e dados pessoais do usuário, a menos que você tenha permissão explícita para retê-los.

​
Matriz de Solução de Problemas

​
Reconciliação de Uso

Use a API de Gerenciamento para reconciliação do lado do servidor:
GET /v1/management/api-keys/{keyId}/usage pode filtrar por scene, model, modelVendor, startDate e endDate. Use esses registros em vez de raspar páginas de dashboard ou depender de IDs de tarefas do provedor. Respostas de streaming podem ser liquidadas após o envio do stream, portanto, um cabeçalho de cobrança pode estar ausente mesmo quando o uso é registrado posteriormente. Tarefas de mídia assíncronas podem ser liquidadas após polling terminal.

​
Modelo de Pacote de Suporte

Ao entrar em contato com o suporte, inclua:
  • request_id.
  • task_id e poll_url para trabalho assíncrono.
  • billing_transaction_id quando presente.
  • Endpoint, método, modelo, timestamp e código de status.
  • Forma da solicitação sanitizada e corpo de erro público.
  • Seu resultado esperado e o que o usuário realmente viu.
Não inclua chaves de API, tokens de gerenciamento, mídia privada, prompts completos, URLs do provedor, IDs de canal ou identificadores privados de diagnóstico, a menos que o suporte do TokenLab peça explicitamente um exemplo redigido.

​
Verificações Operacionais

  • Alerta sobre respostas repetidas 401, 402, 429 e 5xx separadamente; geralmente têm proprietários diferentes.
  • Acompanhe trabalhos assíncronos que permanecem não terminais por mais tempo do que seu SLA de produto.
  • Acompanhe tentativas de criação duplicadas para o mesmo ID de trabalho do usuário.
  • Amostre trabalhos concluídos e verifique se o ativo visível para o usuário, o registro de uso e o registro de tarefa armazenado concordam.

​
Referência da API