Registros y resolución de problemas

Mantenga los IDs de solicitud, tarea y facturación de TokenLab en sus registros. Estos conectan la acción de un usuario con su resultado y cargo sin necesidad de almacenar el prompt o contenido multimedia privado.

En la consola, los detalles capturados de las solicitudes y respuestas están disponibles durante 30 días a partir de su captura, y el acceso finaliza exactamente en el momento del vencimiento, incluso si la limpieza física aún está en cola. La identidad de la solicitud y el historial de facturación/uso tienen ciclos de vida independientes. Consulte Retención de datos.

De una solicitud a una investigación y soporteCopy Anchor Link

1. Abra Solicitudes en el espacio de trabajo al que pertenece la solicitud. Busque su Request ID y seleccione la fila.

2. Elija Open full details para acceder a una página dedicada. Back to requests restaura los filtros de la lista. Un enlace nunca otorga acceso a otro espacio de trabajo; utilice una cuenta autorizada para dicho espacio.

3. Para estados pendientes o desconocidos, primero actualice el progreso. Para una respuesta fallida o interrumpida, elija Investigate the issue cuando esté disponible. Esto inicia una investigación para esa solicitud en el agente integrado; no vuelve a ejecutar la solicitud original del modelo. Las solicitudes exitosas no requieren una investigación de forma predeterminada.

4. Si aún necesita ayuda, elija la acción de soporte humano desde la solicitud o investigación. Se abrirá una vista previa con la solicitud y la conversación vinculadas cuando estén disponibles. Revise el resumen y elimine el contenido privado, luego seleccione explícitamente Submit. Una investigación o una vista previa por sí solas no envían una solicitud de soporte.

5. Después del envío, guarde la confirmación y continúe la misma conversación en Soporte. Reutilícela para respuestas e información adicional en lugar de enviar duplicados.

IDs que debe conservarCopy Anchor Link

Los registros orientados al cliente deben usar IDs de TokenLab. Nunca exponga URLs de servicio privadas, claves de caché o metadatos de diagnóstico.

Qué registrarCopy Anchor Link

Registre lo suficiente para diagnosticar la solicitud sin filtrar secretos:

• Endpoint, método HTTP, modelo, código de estado, marca de tiempo y latencia.
• Identificadores públicos: request_id, task_id, poll_url y billing_transaction_id cuando estén presentes.
• Nombres de campos enviados en la solicitud, no el prompt completo ni contenido multimedia privado.
• Respuestas finales de estado asíncrono y campos de error seguros.
• Recuento de reintentos del cliente y si el reintento creó una nueva tarea o reanudó una existente.

Redacte siempre Authorization, claves de API, tokens de gestión, URLs firmadas, URLs de medios privados, prompts completos y datos personales del usuario, a menos que tenga permiso explícito para conservarlos.

Matriz de resolución de problemasCopy Anchor Link

Conciliación de usoCopy Anchor Link

Utilice la API de gestión para la conciliación del lado del 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 puede filtrar por scene, model, modelVendor, startDate y endDate. Utilice estos registros en lugar de extraer datos de las páginas de la consola o calcular cargos solo a partir de los recuentos de tokens de respuesta.

Las respuestas de streaming pueden liquidarse después de que se envíe el stream, por lo que un encabezado de facturación puede estar ausente incluso cuando el uso se registra posteriormente. Las tareas de medios asíncronas pueden liquidarse después del sondeo terminal.

Qué enviar a soporteCopy Anchor Link

Al contactar a soporte, incluya:

• request_id.
• task_id y poll_url para trabajo asíncrono.
• billing_transaction_id cuando esté presente.
• Endpoint, método, modelo, marca de tiempo y código de estado.
• Nombres de campos de solicitud y el cuerpo de error seguro.
• Su resultado esperado y lo que el usuario vio realmente.

No incluya claves de API, tokens de gestión, medios privados, prompts completos, URLs de servicio privadas o identificadores de diagnóstico. Si soporte necesita un ejemplo de solicitud, envíe una copia redactada.

Verificaciones que vale la pena automatizarCopy Anchor Link

• Alerte sobre respuestas 401, 402, 429 y 5xx repetidas por separado; cada una requiere una respuesta diferente.
• Realice un seguimiento de los trabajos asíncronos que permanecen en estado no terminal más tiempo que su SLA de producto.
• Realice un seguimiento de los intentos de creación duplicados para el mismo ID de trabajo de usuario.
• Muestree trabajos completados y verifique que el activo visible para el usuario, el registro de uso y el registro de tarea almacenado coincidan.

Referencia de APICopy Anchor Link