Entradas Y Media Assets
Las tareas World pueden empezar desde texto, imágenes, varias imágenes o video según el modelo seleccionado y la forma de la solicitud. Para prompts multimedia reutilizables, prepara primero un media asset y luego referéncialo en la solicitud World. Los media assets y Worlds completados solo están disponibles para tu cuenta.Crear Y Consultar
Las respuestas de creación incluyen un ID público de tarea y normalmente una poll_url. Guarda ese ID antes de mostrar progreso y luego sigue poll_url o GET /v1/tasks/ hasta que la tarea sea completed o failed.Administrar Worlds Completados
Usa los endpoints de lista y detalle de Worlds para Worlds completados disponibles en tu cuenta. Usa endpoints de estado de tarea para generaciones pendientes o fallidas. Elimina solo cuando el usuario quite intencionalmente el World generado de tu producto.Errores Comunes
- No asumas que todos los modelos World soportan todos los tipos de entrada.
- Mantén las URLs firmadas de imagen o video válidas el tiempo suficiente para reintentos de descarga del servicio.
- Guarda el ID de tarea devuelto antes de reintentar tras un timeout.
- Usa generación 3D para archivos de modelo descargables, no para Worlds explorables.