API de generación de video NSFW: guía rápida de la Nureta Developer API

La Nureta Developer API es el motor que hace funcionar la app de consumo de Nureta, expuesto por HTTPS para desarrolladores, estudios y apps. Una sola clave de API cubre la generación de video, imágenes y guiones, con el mismo ciclo de vida de tarea: crear, consultar, estado final. Los modelos de video son seahorse-480p, seahorse-720p y seahorse-1080p. Puedes renderizar clips sueltos de 5, 8, 10, 12 o 15 segundos, o escenas unidas de varios planos de 16 a 180 segundos, con audio generado por defecto.

Para un control más fino puedes adjuntar hasta 9 imágenes de referencia, fijar first_frame o last_frame, o enviar tu propio storyboard segments[], donde cada plano tiene su guion, una duración de 4 a 15 segundos y un indicador explicit, de modo que los planos de preparación siguen sin ser explícitos y los del clímax sí lo son. El modo edit prepara un borrador del storyboard y lo deja en estado planned con imágenes de vista previa, para que cambies beats antes de pagar el render.

La configuración tiene tres pasos. Primero, inicia sesión en developer.nureta.ai con Google. Segundo, crea una clave de API en tu cuenta (pasos en https://developer.nureta.ai/docs); las claves nuevas permiten 10 peticiones por segundo, ajustables entre 1 y 100. Tercero, recarga tu saldo prepago con USDC en Base desde la página Billing, donde 1 USDC equivale a $1.00 y no hace falta tarjeta. No hay que esperar a ninguna solicitud de credenciales aparte.

Trata la clave como cualquier otro secreto. Guárdala en una variable de entorno, mantenla en tu servidor, nunca la incluyas en código de navegador o de móvil y rótala si se filtra. Cada llamada se autentica con la clave como token bearer: Authorization: Bearer sk-.... Si tu saldo no alcanza para una tarea nueva, la API devuelve AccountOverdueError en lugar de cobrarte después.

Una petición mínima de texto a video de 5 segundos es una sola llamada con curl: curl -X POST https://developer.nureta.ai/api/v3/contents/generations/tasks -H "Authorization: Bearer sk-..." -H "Content-Type: application/json" -d '{"model":"seahorse-480p","content":[{"type":"text","text":"two adults share a slow dance in a candlelit loft"}],"duration":5}'. La respuesta es un id de tarea como {"id":"cgt-..."}.

A partir de ahí añades campos según los necesites. Pon duration hasta 180 para una escena unida, añade "ratio":"9:16" para video vertical (también valen 16:9, 4:3, 3:4, 1:1, 21:9 y adaptive), adjunta elementos image_url como imágenes de referencia o pasa callback_url para recibir un webhook. Escribe el prompt como una escena corta y en orden: quiénes son los personajes adultos ficticios, dónde están y qué pasa. Una prosa clara funciona mejor que un montón de palabras clave.

El video tarda minutos, así que la API es asíncrona. Consulta GET /api/v3/contents/generations/tasks/{id} con la misma clave bearer hasta que status sea succeeded o failed; una tarea correcta incluye content.video_url. Mientras avanza, un objeto step informa de la fase, por ejemplo {"code":"rendering","done":3,"total":5}, suficiente para mover una barra de progreso. Descarga el archivo y guárdalo de tu lado cuanto antes.

Consultar el estado es opcional. Pasa callback_url al crear la tarea y Nureta enviará por POST el objeto final de la tarea a tu endpoint HTTPS cuando termine bien o mal. Añade un callback_secret y cada entrega irá firmada con HMAC-SHA256, que debes verificar antes de fiarte de ella. La entrega es «al menos una vez», así que deduplica por id de tarea. Una generación fallida se reembolsa automáticamente a tu saldo.

El precio es por segundo de video y se descuenta de tu saldo prepago. Tabla de precios: seahorse-480p cuesta $0.1888 por segundo ($0.944 por 5 segundos); seahorse-720p, $0.2773 por segundo ($1.3864 por 5 segundos); seahorse-1080p, $0.5428 por segundo ($2.7139 por 5 segundos). Una escena de 60 segundos en 480p cuesta unos $11.33. El endpoint público GET /api/v3/models devuelve los precios vigentes, así que consúltalo en lugar de fijar las cifras en el código.

El importe se reserva al crear la tarea y se reembolsa si la tarea falla, así que un render fallido no cuesta nada. Esto es distinto de la app de consumo de Nureta, que cobra $1.29 por video de 5 segundos pagado en USDC y regala un primer video de 5 segundos al iniciar sesión con Google. Mantén ambos separados al presupuestar a un cliente: el precio por segundo es para código; el precio por video, para quienes usan nureta.ai.

El uso de la API está sujeto a la política de contenido de Nureta: solo adultos, nada de menores (incluidos los ficticios), nada de personas reales sin su consentimiento, nada de figuras públicas y nada de contenido no consentido. Las imágenes de referencia que parecen de una figura pública se rechazan automáticamente. Las fotos de rostro solo se pueden usar con el consentimiento del adulto que aparece para contenido adulto, y la API no ofrece ninguna función de intercambio de caras ni de «desnudar». Las infracciones se comunican al NCMEC cuando la ley lo exige.

Si construyes un producto para tus propios usuarios, la política se aplica también a ellos. Exige a tus usuarios una verificación de mayoría de edad (18+), recoge el consentimiento de cualquier foto que suban y mantén las escenas en la ficción. Hay SDK disponibles bajo petición; todos los ejemplos funcionan con curl, así que cualquier lenguaje que pueda hacer una petición HTTPS puede integrarse.