OneUpRender

← Documentación de la API

OneUpRender es el motor determinista de producción de video de OneUpAI. Describes un video como un Timeline — una receta JSON de clips, composiciones, texto, transiciones y audio — y el motor lo renderiza exactamente, siempre. Sin prompts ni sorpresas: el mismo Timeline produce siempre el mismo video.

Cómo funciona

  1. Crea un Proyecto y escribe un Timeline (JSON). Tus medios entran como archivos subidos o generados — el motor nunca inventa metraje.
  2. Renderiza una Vista previa para iterar rápido y luego un final. La validación es estricta y anticipada: un Timeline inválido se rechaza por nombre antes de cobrar nada.
  3. El video terminado llega a tu biblioteca como cualquier generación — duradero, privado, con URLs renovables.

Precios

El renderizado se mide en créditos por cada 10 segundos iniciados de salida (consulta la tarifa en vivo en los alias de render de la página de documentación). Los segmentos repetidos usan la caché de render, por eso iterar sobre una sección de un video largo sigue siendo rápido.

Familias de primitivas

Cada operación es una primitiva con nombre, versión y contrato fijo. La disponibilidad proviene en vivo del manifiesto de capacidades:

44 de 45 operaciones están disponibles hoy — el resto está declarado en el lenguaje Timeline bloqueado y se gradúa puerta de ingeniería por puerta.

Fuentes y encuadre

De dónde vienen los píxeles de un segmento y cómo se ajustan al cuadro de salida.

  • $asset (your media) entregada
  • solid color entregada
  • fit: cover entregada
  • fit: contain entregada
  • fit: smart_crop lista para activar — a la espera de needs:tracking

Composiciones y pantallas divididas

Composiciones multi-cuadro: divisiones lado a lado y apiladas, 3-up, cuadrículas 2×2 y 2×3, y composiciones libres con celdas explícitas — con etiquetas por celda (el clásico ANTES/DESPUÉS). El picture-in-picture es un overlay.

  • compose — 2up_h · 2up_v (split screens) · 3up · grid_2x2 · grid_2x3 · free entregada
  • compose: the heard panel entregada

Movimiento y tiempo

Ken Burns y push-ins, punch zooms, snap zooms, rampas de velocidad, congelados, reversa, vibración de cámara, fundidos.

  • zoom entregada
  • fade entregada
  • kenburns entregada
  • snap_zoom entregada
  • speed_ramp entregada
  • freeze entregada
  • reverse entregada
  • shake entregada
  • filter_preset entregada
  • rotate entregada
  • v360 entregada
  • stabilize entregada
  • parallax entregada

Transiciones

Recetas de unión fijas y versionadas entre segmentos:

  • cut entregada
  • seamless_spin entregada
  • crossfade entregada
  • fade_black entregada
  • fade_white entregada
  • slide entregada
  • wipe entregada
  • whip entregada
  • zoom_in entregada
  • zoom_out entregada
  • circle_open entregada
  • circle_close entregada
  • pixelate entregada
  • blur_dissolve entregada

Texto y subtítulos

Subtítulos sincronizados por palabra (palabra a palabra, karaoke, resaltado de palabras clave), titulares, pop-ups, callouts, tercios inferiores, CTAs, contadores, barras de progreso y gráficos de stock — flechas, círculos, insignias.

  • captions (word-timed) entregada
  • captions: one word at a time entregada
  • captions: phrase chunks entregada
  • captions: entrance / exit entregada
  • text overlays entregada
  • stock graphics entregada

Overlays

Picture-in-picture, video inserto, logotipos y marcas de agua sobre los segmentos.

  • image overlays / PiP entregada
  • video overlays / inset entregada

Audio

Pistas de música, voz y efectos con ducking, cortes J/L, efectos puntuales (whooshes, impactos), reducción de ruido y mezcla con sonoridad normalizada.

  • music / voiceover tracks entregada
  • ducking entregada
  • SFX one-shots entregada

Nuevo: seamless_spin

Una transición de giro tipo látigo — la cámara parece girar rápidamente por el espacio de una toma a la siguiente, con desenfoque de movimiento que oculta el cambio. Pensada para secuencias foto a foto (propiedades, antes/después, sets de producto). La dirección puede alternar automáticamente; intensidad, desenfoque, zoom y perspectiva son ajustables.

Ejemplo: dos fotos unidas por un giro

{
  "op": "seamless_spin",
  "duration": 1200,
  "direction": "auto",
  "intensity": 0.8,
  "motion_blur": 0.65
}

Qué construye la gente con esto

Revelados antes / después

Comparación en pantalla dividida con etiquetas y luego un giro perfecto hacia el primer plano. La receta es una plantilla de Timeline — cambia las dos fotos y cada render mantiene la marca y la estructura idéntica.

Videos de propiedades

Un set de fotos se convierte en un recorrido: movimiento Ken Burns por habitación, giros entre habitaciones, subtítulos desde un guion, música con ducking automático y tarjeta CTA de cierre.

Shorts subtitulados

Convierte una grabación larga en un short vertical: punch-ins, subtítulos palabra a palabra, pops de palabras clave, golpes de SFX y sonoridad normalizada para cada plataforma.

Por qué importa el determinismo

Como un Timeline se renderiza idéntico cada vez, las plantillas son confiables (un agente puede entregar la misma receta a mil clientes), iterar es barato (los segmentos sin cambios salen de la caché) y nada en tu video es alucinado — tus medios son la única fuente de píxeles.