Guias principais
Retenção de dados
Por quanto tempo você pode acessar detalhes de solicitações e mídia, e como manter resultados importantes
Os detalhes de solicitações e respostas, e os resultados de mídia salvos automaticamente, ficam disponíveis por 30 dias. O histórico de conversas, registros de faturamento, Media Assets salvos e arquivos que você baixa são tratados separadamente.
Consulte TokenLab data retention para a explicação completa.
Detalhes de solicitações e respostas
O conteúdo salvo de solicitações e respostas fica disponível no Console, no Request Debugger e no TokenLab Agent (Assistant) por 30 dias a partir do momento em que é registrado. Após o vencimento, essas ferramentas não conseguem mais recuperar esse conteúdo original. Resumos de solicitações, uso e registros de faturamento podem continuar disponíveis. Baixe todos os detalhes de que precisar antes que expirem.
Uma captura expirada é diferente de um conteúdo que nunca foi salvo ou que não pôde ser carregado. Verifique o status exibido ao solucionar problemas.
Mídia gerada
O TokenLab salva automaticamente cópias de resultados de imagem, vídeo, áudio e arquivos 3D para download (incluindo arquivos Worlds) retornados como links HTTP(S). Cada URL de mídia que você recebe para esses resultados é uma URL do TokenLab: em respostas de API, leituras de status de tarefa, resultUrls de webhook task.completed e content.video_url e content.last_frame_url de callback compatível com Seedance.
https://api.tokenlab.sh/v1/media-results/{id}.{ext}?token=…A extensão corresponde ao tipo de mídia, por exemplo png, mp4, mp3 ou glb. A URL permanece válida por 30 dias a partir do momento em que o resultado é registrado pela primeira vez. Visualizá-la novamente, tentar novamente ou verificar o status da tarefa não reinicia esse período.
A URL funciona assim que você a recebe. Enquanto o TokenLab ainda está salvando sua cópia, a URL transmite o arquivo da fonte através do TokenLab. Quando a cópia está pronta, a URL serve a cópia. Se o salvamento falhar, a URL transmite da fonte por até 24 horas após a criação do resultado, depois retorna HTTP 410.
Para acesso prolongado, baixe o arquivo ou salve-o em Media Assets enquanto estiver disponível. Uma cópia salva em Media Assets não expira com a cópia automática de 30 dias.
O salvamento automático não cobre páginas interativas de Worlds, dependências de modelos referenciadas externamente, mídia em Base64 ou binária inline, arquivos de entrada ou links dentro de texto gerado. Salve esses resultados você mesmo se precisar deles mais tarde. Os registros de tarefas têm um tempo de vida separado; uma tarefa concluída não garante que sua mídia ainda esteja disponível.
Verificando a disponibilidade de mídia através da API
As respostas JSON do protocolo de IA incluem media_retention para resultados suportados: days e items, com cada item relatando url, kind, status (saved, saving, failed ou expired), expires_at e, quando conhecido, content_type. Se o status de salvamento não for conhecido dentro do limite de tempo da resposta, a resposta omite media_retention; a URL de mídia ainda funciona. Você também pode adicionar metadata=true a uma URL de resultado de mídia para verificar seu status atual. Ela retorna status, expires_at, content_type e kind. Um status saving ou failed não significa que o arquivo foi salvo.
Tarefas com falha ou em andamento retornam campos de URL de mídia vazios.
| Resposta da URL de resultado de mídia | Significado | O que fazer |
|---|---|---|
404 media_not_found | O token ou a extensão do arquivo não corresponde ao resultado | Use a URL exata que você recebeu |
410 media_expired | O período de 30 dias terminou, ou o salvamento falhou há mais de 24 horas | O arquivo não está mais disponível através do TokenLab |
502 ou 503 media_unavailable | O resultado ainda está sendo gravado, ou o TokenLab está ocupado | Tente novamente após o atraso Retry-After quando presente, ou após uma breve espera |
Para resultados de imagem, vídeo e áudio, a URL de resultado de mídia redireciona para uma URL de download que dura no máximo cinco minutos. Se esse link expirar enquanto o resultado ainda estiver dentro da janela de 30 dias, solicite a URL de resultado de mídia novamente. Isso não estende a expiração do resultado. Arquivos 3D são transmitidos a partir da própria URL de resultado de mídia.
Histórico de conversas do TokenLab Agent (Assistant)
Estas são suas conversas com o assistente integrado do TokenLab. Elas são armazenadas separadamente dos logs de solicitação da API e não são removidas automaticamente quando esses logs atingem 30 dias. O texto já salvo em uma conversa pode permanecer lá, mas detalhes de solicitações e mídias expiradas não podem ser carregados novamente a partir dessa conversa.
Você pode remover uma conversa do histórico do Agent. Isso a remove da lista de histórico; não apaga todos os dados associados nem remove o histórico de solicitações, faturamento, suporte ou Console. O Assistant pode investigar o conteúdo original da solicitação e resposta apenas enquanto estiver dentro da janela de 30 dias; registros de faturamento e uso mais antigos podem continuar disponíveis.
Outros registros e arquivos
- Informações da conta, histórico de faturamento e uso, e registros de tarefas são mantidos separadamente para fornecer serviços de conta, faturamento e suporte. Sua retenção não é limitada à janela de 30 dias de detalhes de solicitação.
- Arquivos de exportação de registros de chamadas da organização estão disponíveis para download por 90 dias. Baixe-os antes que expirem; a expiração de uma exportação não exclui os registros subjacentes.
- Arquivos temporários carregados no Console ou no TokenLab Agent (Assistant) podem ser usados em novas solicitações por 24 horas. Depois disso, carregue o arquivo novamente se precisar usá-lo em uma nova solicitação.
- Arquivos que você baixa ou exporta, armazenamento do navegador e cópias salvas por sua própria aplicação estão sob seu controle. Os limites de retenção do TokenLab não excluem essas cópias.
Os períodos acima descrevem a disponibilidade através do TokenLab. A exclusão do armazenamento pode ser concluída após a expiração do acesso. Provedores de serviços de IA que processam suas solicitações têm suas próprias políticas de dados e períodos de retenção.
Para solução de problemas de solicitação, consulte Logs e solução de problemas. Para sondagem de tarefas de mídia, consulte Tarefas assíncronas e polling.