Guías principales
Retención de datos
Cuánto tiempo puede acceder a los detalles de las solicitudes y archivos multimedia, y cómo conservar los resultados importantes
Los detalles de las solicitudes y respuestas, así como los resultados multimedia guardados automáticamente, están disponibles durante 30 días. El historial de conversaciones, los registros de facturación, los Media Assets guardados y los archivos que descarga se gestionan por separado.
Consulte TokenLab data retention para obtener la explicación completa.
Detalles de solicitudes y respuestas
El contenido guardado de las solicitudes y respuestas está disponible en Console, Request Debugger y TokenLab Agent (Assistant) durante 30 días a partir del momento en que se registra. Tras su vencimiento, estas herramientas ya no pueden recuperar dicho contenido original. Los resúmenes de solicitudes, el uso y los registros de facturación pueden seguir estando disponibles. Descargue cualquier detalle que necesite antes de que caduque.
Una captura caducada es diferente de un contenido que nunca se guardó o que no pudo cargarse. Compruebe el estado que se muestra al solucionar problemas.
Contenido multimedia generado
TokenLab guarda automáticamente copias de resultados de imágenes, vídeos, audio y archivos 3D descargables compatibles (incluidos los archivos Worlds) que se devuelven como enlaces HTTP(S). Cada URL de contenido multimedia que recibe para estos resultados es una URL de TokenLab: en las respuestas de la API, las lecturas de estado de tareas, los resultUrls del webhook task.completed y los campos content.video_url y content.last_frame_url de la devolución de llamada compatible con Seedance.
https://api.tokenlab.sh/v1/media-results/{id}.{ext}?token=…La extensión coincide con el tipo de contenido multimedia, por ejemplo png, mp4, mp3 o glb. La URL permanece válida durante 30 días a partir de la fecha en que se registra el resultado por primera vez. Verlo de nuevo, reintentar o comprobar el estado de la tarea no reinicia ese periodo.
La URL funciona tan pronto como la recibe. Mientras TokenLab sigue guardando su copia, la URL transmite el archivo desde la fuente a través de TokenLab. Cuando la copia está lista, la URL sirve la copia. Si el guardado falla, la URL transmite desde la fuente hasta 24 horas después de que se creara el resultado, tras lo cual devuelve un error HTTP 410.
Para un acceso más prolongado, descargue el archivo o guárdelo en Media Assets mientras esté disponible. Una copia guardada en Media Assets no caduca con la copia automática de 30 días.
El guardado automático no cubre las páginas interactivas de Worlds, las dependencias de modelos referenciadas externamente, el contenido multimedia en Base64 o binario en línea, los archivos de entrada ni los enlaces dentro del texto generado. Guarde estos resultados usted mismo si los necesita más adelante. Los registros de tareas tienen un tiempo de vida independiente; una tarea completada no garantiza que su contenido multimedia siga estando disponible.
Comprobación de la disponibilidad de contenido multimedia a través de la API
Las respuestas JSON del protocolo de IA incluyen media_retention para los resultados compatibles: days y items, donde cada elemento informa de url, kind, status (saved, saving, failed o expired), expires_at y, cuando se conoce, content_type. Si el estado de guardado no se conoce dentro del límite de tiempo de respuesta, la respuesta omite media_retention; la URL del contenido multimedia sigue funcionando. También puede añadir metadata=true a una URL de resultado multimedia para comprobar su estado actual. Devuelve status, expires_at, content_type y kind. Un estado saving o failed no significa que el archivo se haya guardado.
Las tareas fallidas y en curso devuelven campos de URL de contenido multimedia vacíos.
| Respuesta de la URL de resultado multimedia | Significado | Qué hacer |
|---|---|---|
404 media_not_found | El token o la extensión del archivo no coinciden con el resultado | Utilice la URL exacta que recibió |
410 media_expired | El periodo de 30 días ha finalizado, o el guardado falló hace más de 24 horas | El archivo ya no está disponible a través de TokenLab |
502 o 503 media_unavailable | El resultado aún se está registrando o TokenLab está ocupado | Reintente después del retraso Retry-After cuando esté presente, o tras una breve espera |
Para los resultados de imagen, vídeo y audio, la URL del resultado multimedia redirige a una URL de descarga que dura como máximo cinco minutos. Si ese enlace caduca mientras el resultado sigue dentro de su ventana de 30 días, solicite de nuevo la URL del resultado multimedia. Esto no extiende la caducidad del resultado. Los archivos 3D se transmiten desde la propia URL del resultado multimedia.
Historial de conversaciones de TokenLab Agent (Assistant)
Estas son sus conversaciones con el asistente integrado de TokenLab. Se almacenan por separado de los registros de solicitudes de la API y no se eliminan automáticamente cuando dichos registros alcanzan los 30 días. El texto ya guardado en una conversación puede permanecer allí, pero los detalles de las solicitudes y el contenido multimedia caducados no pueden volver a cargarse desde esa conversación.
Puede eliminar una conversación del historial de Agent. Esto la elimina de la lista del historial; no borra todos los datos asociados ni elimina el historial de solicitudes, facturación, soporte o Console. El Assistant puede investigar el contenido original de la solicitud y la respuesta solo mientras se encuentre dentro de la ventana de 30 días; los registros de facturación y uso más antiguos pueden seguir estando disponibles.
Otros registros y archivos
- La información de la cuenta, el historial de facturación y uso, y los registros de tareas se mantienen por separado para proporcionar servicios de cuenta, facturación y soporte. Su retención no se limita a la ventana de 30 días de los detalles de las solicitudes.
- Los archivos de exportación de registros de llamadas de la organización están disponibles para su descarga durante 90 días. Descárguelos antes de que caduquen; la caducidad de una exportación no elimina los registros subyacentes.
- Los archivos temporales cargados en Console o TokenLab Agent (Assistant) pueden utilizarse en nuevas solicitudes durante 24 horas. Después de eso, vuelva a cargar el archivo si necesita utilizarlo en una nueva solicitud.
- Los archivos que descarga o exporta, el almacenamiento del navegador y las copias guardadas por su propia aplicación están bajo su control. Los límites de retención de TokenLab no eliminan esas copias.
Los periodos anteriores describen la disponibilidad a través de TokenLab. La eliminación del almacenamiento puede finalizar después de la caducidad del acceso. Los proveedores de servicios de IA que procesan sus solicitudes tienen sus propias políticas de datos y periodos de retención.
Para la resolución de problemas de solicitudes, consulte Registros y resolución de problemas. Para el sondeo de tareas multimedia, consulte Tareas asíncronas y polling.