¿Por qué falló mi generación en Hyper3D?
Soluciona los fallos de generación revisando las entradas, los parámetros de la API, el acceso a la cuenta, los créditos y el estado de la tarea. Si el problema persiste, reúne los detalles relevantes para contactar con soporte.
¿Por qué falló mi generación en Hyper3D?
Una generación en Hyper3D puede fallar antes de que se acepte la tarea, durante su procesamiento o mientras el cliente recupera el resultado. Cada etapa tiene causas distintas y un tratamiento diferente de los créditos. Guarda el error exacto y el identificador de la tarea antes de volver a intentarlo.
Causas frecuentes
- La imagen o el archivo 3D de entrada está dañado, tiene un formato no compatible, es mayormente transparente, es demasiado pequeño o no muestra un sujeto claramente definido.
- El prompt o el contenido cargado no se puede procesar según las normas vigentes de contenido o seguridad.
- Un parámetro de la API, una URL de archivo, un formato o una combinación de opciones no es válido para el endpoint seleccionado.
- La cartera (Wallet) seleccionada no tiene créditos disponibles, acceso al modelo o los permisos de suscripción necesarios.
- Un problema temporal del servicio, la carga, la red o la cola interrumpió el procesamiento.
Qué puedes probar
- Lee el error completo en lugar de enviar repetidamente la misma solicitud.
- Para las imágenes, utiliza un sujeto claramente definido, un formato compatible, una URL estable y un primer plano que no sea transparente. Para el texto, simplifica las instrucciones contradictorias.
- Para las llamadas a la API, comprueba los nombres actuales de los parámetros y los valores permitidos por el endpoint. Después, consulta periódicamente el UUID de la tarea devuelto hasta que alcance un estado final, en lugar de interpretar un estado pendiente inicial como un fallo.
- Comprueba la cartera personal o del equipo (Team Wallet) correspondiente, sus créditos disponibles y bloqueados, y el historial (History).
- Si el error parece temporal, vuelve a intentarlo una sola vez tras una breve espera.
Créditos y tareas fallidas
En la web, Hyper3D utiliza un flujo de confirmación de resultados en los procesos compatibles: la vista previa o la repetición pueden ser gratuitas, la confirmación cuesta créditos y los créditos bloqueados que no se utilicen se liberan cuando termina el temporizador mostrado. Para las tareas de la API, consulta el valor consumed de la respuesta y el registro de la cartera; la documentación pública no garantiza un mismo resultado de reembolso para todos los fallos definitivos.
Cuándo contactar con soporte
Si la misma entrada válida falla repetidamente, o si una tarea que ha terminado con un fallo deja un cargo inesperado, contacta con soporte a través de Feedback o hello@help.hyper3d.ai. Incluye el UUID de la tarea (o el enlace al recurso), el endpoint o modelo, la hora de la solicitud, el estado final, el error exacto, el tipo de cartera, el registro de créditos y un ejemplo de entrada que sea seguro compartir. No envíes claves de API, contraseñas ni datos privados de pago.