Observabilidade & Solução de Problemas

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.

Da solicitação à investigação e ao suporteCopy Anchor Link

1. Abra Solicitações no workspace responsável. Localize o Request ID e selecione a linha.

2. Abra os detalhes completos em uma página própria. Voltar à lista restaura os filtros. Um link não concede acesso a outro workspace; use uma conta autorizada.

3. Se o status estiver pendente ou desconhecido, atualize primeiro o progresso. Em falhas ou respostas interrompidas, inicie a investigação disponível no Agent integrado. Ela não reenvia a solicitação original ao modelo. Solicitações bem-sucedidas não precisam de investigação por padrão.

4. Se precisar de ajuda, escolha suporte humano na solicitação ou investigação. Revise a prévia e os vínculos disponíveis com a solicitação e a conversa, remova dados privados e envie explicitamente. Abrir uma investigação ou prévia não envia uma solicitação ao suporte.

5. Guarde a confirmação e continue a mesma conversa em Suporte para receber respostas e complementar informações, sem duplicar solicitações.

Identificadores Públicos a CapturarCopy Anchor Link

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 RegistrarCopy Anchor Link

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 ProblemasCopy Anchor Link

Reconciliação de UsoCopy Anchor Link

Use a API de Gerenciamento para reconciliação do lado do servidor:

curl "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456/usage?page=1&limit=20&scene=video" \
  -H "Authorization: Bearer mt-your-management-token"

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 SuporteCopy Anchor Link

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 OperacionaisCopy Anchor Link

• 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 APICopy Anchor Link