Automatiza la producción de vídeo para adultos con una API

Un pipeline de producción sobre la Nureta Developer API suele tener cinco etapas. Etapa 1, ideación: convertir una premisa en un guion estructurado. Etapa 2, recursos: subir o generar imágenes de referencia. Etapa 3, render: crear una tarea de vídeo a partir del guion. Etapa 4, revisión: opcionalmente detener el guion gráfico para que una persona lo apruebe. Etapa 5, entrega: recibir la URL del vídeo terminado por webhook y publicarlo en tu producto. Todas las etapas usan la misma clave bearer y el mismo ciclo crear, consultar, estado final, así que un pequeño servicio worker puede mover toda la cadena.

La decisión de diseño clave es tratar cada generación como un trabajo duradero, no como una llamada HTTP bloqueante. Renderizar una escena de un minuto lleva minutos, así que tu código debe enviar, guardar el id de la tarea y seguir. Eso hace que el pipeline sea reanudable: si un worker se cae, la tarea sigue ejecutándose en Nureta y tu cola sabe qué id consultar.

Empieza por la generación de guiones, con diferencia la etapa más barata. POST /api/v3/contents/scripts con {"model":"seahorse-script","content":[{"type":"text","text":"el reencuentro nocturno de dos antiguos amantes"}],"duration":60} cuesta $0.01 fijos sea cual sea la duración. El resultado trae un título, los nombres de los personajes y una lista de escenas, cada una con setting, beat y durationSeconds. El parámetro duration (5–180 segundos) cambia el número de escenas, no el precio.

Esas escenas encajan casi directamente en un guion gráfico de vídeo. Decide si cada beat es preparación o clímax y pásalos como segments[] con su propio duration_seconds (4–15) y su indicador explicit. Para las referencias, POST /api/v3/contents/uploads devuelve una URL firmada de corta duración; subes los bytes de la imagen con PUT y usas en la tarea el assetUrl devuelto. Subir es gratis, pero la firma de URLs está limitada a 30 peticiones por minuto por clave, así que agrupa las subidas.

Envía los renders desde un worker de cola con POST /api/v3/contents/generations/tasks y guarda el id devuelto de inmediato, antes de que nada más pueda fallar. El precio se reserva del saldo al crear la tarea, así que un envío correcto significa que el trabajo ya está pagado. Si una llamada HTTP agota el tiempo y no sabes si la tarea se creó, revisa tus registros y la lista de tareas antes de reenviar; los reintentos a ciegas son la forma en que un pipeline paga dos veces.

Para el seguimiento, cada tarea de vídeo expone un objeto step. Los códigos incluyen queued, generating_script, generating_visuals, rendering (con clips hechos y totales), stitching, done y failed. Tradúcelos a tus propias etiquetas, porque la API nunca envía texto de interfaz. Consultar funciona, pero cada petición cuenta para el límite de la clave (10 peticiones por segundo por defecto, ajustable de 1 a 100), así que a gran volumen conviene usar webhooks por defecto.

Define callback_url en cada tarea y Nureta enviará por POST el objeto final de la tarea, idéntico al que devuelve GET, a tu endpoint HTTPS cuando termine bien o mal. Añade callback_secret (8–256 caracteres) y verifica cada entrega: calcula HMAC-SHA256 sobre la cabecera de marca de tiempo, un punto y el cuerpo en bruto, y compáralo en tiempo constante con la cabecera de firma. Rechaza todo lo que no coincida.

Haz que el receptor sea aburrido e idempotente. La entrega es «al menos una vez» con hasta 5 intentos, así que deduplica por id de tarea. Devuelve cualquier 2xx en menos de 5 segundos y haz el trabajo pesado (descargar, transcodificar, publicar) de forma asíncrona, porque una respuesta lenta cuenta como fallo y no se siguen redirecciones. La URL debe ser HTTPS y no puede apuntar a direcciones privadas ni de loopback. Mantén una consulta periódica lenta como red de seguridad.

La automatización total sirve para volumen de bajo riesgo, pero todo lo que publiques con tu marca merece una puerta de revisión con el modo edit. Envía con "mode":"edit" y la tarea se cobra, prepara un guion gráfico y se detiene en estado planned con una vista previa del personaje, guiones por plano, duraciones, indicadores explicit y vistas previas de fondos sin personas. Un revisor puede cambiar beats o fotogramas y luego llamar a POST …/tasks/:id/render, o a POST …/tasks/:id/cancel para un reembolso completo inmediato. Los borradores que nadie renderiza se reembolsan automáticamente.

Automatizar no te quita la responsabilidad de cumplimiento. Todo lo que se genera con la Nureta Developer API está sujeto a la política de contenido de Nureta: solo adultos, nada de menores (tampoco ficticios), nada de personas reales sin consentimiento, nada de figuras públicas, nada de contenido no consentido. Si tu pipeline sirve a usuarios finales, verifica tú su edad y registra el consentimiento de las fotos de referencia antes de que lleguen a una tarea.

La API cobra por segundo de vídeo desde un saldo prepago: $0.1888 por segundo en 480p, $0.2773 en 720p y $0.5428 en 1080p. Un ejemplo: 50 escenas de un minuto en 480p cuestan 50 × 60 × $0.1888 = $566.40, más 50 borradores de guion a $0.01 = $0.50, más 100 imágenes de referencia a $0.05 = $5.00, en total $571.90. Las generaciones fallidas se reembolsan automáticamente, así que el coste real queda en esa cifra o por debajo.

El modelo prepago es además tu disyuntor. Cuando el saldo no cubre una tarea nueva, la API devuelve AccountOverdueError en lugar de acumular gasto sin límite, así que un bug que crea tareas en bucle se detiene cuando se agota el saldo. No lo confundas con la app de consumo de Nureta, que cobra $1.29 por vídeo de 5 segundos en 480p en USDC y está pensada para una persona que hace una película, no para pipelines.