Trabajos asíncronos

Las peticiones de imagen, vídeo y audio comparten un registro interno de Prediction. Los estados canónicos son queued, processing, succeeded, failed, cancelled y expired. Antes de empezar a consultar, guarda el ID de generación o de Prediction devuelto, el modelo, la región, la hora de envío y tu ID interno de trabajo.

Consulta GET /predictions/:id con retroceso exponencial y jitter. Los clientes de vídeo existentes pueden seguir usando GET /videos/generations/:id. Detente en cualquier estado terminal y continúa la conciliación en un worker si la persona usuaria abandona la página.

Las predicciones expiran siete días después del ciclo de vida de su registro. DELETE /predictions/:id devuelve la Prediction terminal sin cambios, o 409 cancellation_not_supported cuando la operación del proveedor elegida no puede cancelar de forma segura un trabajo en curso.

Reintenta las lecturas de estado con libertad dentro de los límites de uso. No reenvíes a ciegas peticiones de generación tras un tiempo de espera ambiguo: eso puede crear un trabajo facturable adicional. Concilia primero la petición original.

Abre la página del modelo para consultar parámetros y precios actuales. Las cuatro páginas de Wan 3 incluyen una sección API debajo del Playground. GET /v1/models ofrece los esquemas y el acceso permitido a tu clave; GET /api/model-pricing devuelve los precios actuales para el cliente.

Las solicitudes de imagen de MuleRouter pueden devolver HTTP 202, id y poll_url. Consulta esa URL con la misma clave; GET /v1/predictions/:id termina con succeeded y outputs. Z-Image Pro Spicy acepta width y height de 256 a 2560 (1024 por defecto), n = 1 y prompt_extend = false por defecto. Z-Image Spicy también genera una imagen por solicitud. No copies los límites de tamaño o cantidad de otro modelo.

GET /v1/videos/generations/:id termina con completed o failed y devuelve video_url al completarse. GET /v1/predictions/:id usa succeeded y outputs. Sigue el contrato del poll_url utilizado. Los vídeos de referencia y de salida de Wan 3 no pueden superar 30 segundos en total. Solo Prime y Prime Pro aceptan prompt_extend actualmente. LoRA admite tres listas opcionales de pesos, 480P/720P y 5/8 segundos. Wan Animate y FlashVSR usan el endpoint de vídeo con medios de origen.