Runway: Aleph 2.0
Aleph 2.0 edita vídeos existentes mediante instrucciones de texto específicas y orientación por fotogramas clave. Utilícelo para sustituir un objeto o cambiar el fondo, el vestuario, la iluminación o el estilo, indicando qué detalles de la escena original deben mantenerse intactos.
Sobre el modelo
Esta descripción cubre las capacidades del modelo. Las entradas, salidas y opciones disponibles en Ailoot se indican a continuación para el método seleccionado.
Aleph 2.0 es el modelo de Runway para edición de vídeo en contexto. Transforma material tradicional o generado existente mediante una instrucción escrita y orientación opcional por fotogramas clave. Su flujo previsto modifica la parte solicitada de una escena conservando la composición, la iluminación y los detalles circundantes, lo que lo hace útil para sustituir un producto, cambiar vestuario, transformar fondos, modificar iluminación o cambiar el estilo visual sin recrear toda la escena desde un encargo escrito.
Comience con una acción directa y la transformación deseada: añadir, eliminar, sustituir, cambiar, volver a iluminar o cambiar el estilo. Para sustituir un producto, identifique el objeto visible y describa su sustituto; después indique qué movimiento de la mano, movimiento de cámara y entorno circundante deben permanecer. Para una escena estacional, describa el tiempo atmosférico o la luz que deben cambiar. Una instrucción concisa y específica ofrece un objetivo de edición más claro que una petición general de mejorar todo el clip.
La orientación por fotogramas clave establece cómo debe verse el resultado editado en un momento concreto. Elija un fotograma que muestre claramente el objetivo: una vista amplia para cambiar un fondo o una vista más cercana para un rasgo o accesorio pequeño. En el flujo Edit Studio de Runway, puede previsualizarse y perfeccionarse una edición de fotograma fijo antes de que esa versión seleccionada oriente la transformación del vídeo. Compare el fotograma editado con el original para comprobar los detalles, bordes y objetos del sujeto que pretende conservar y después utilícelo como dirección visual del clip.
La API del fabricante admite vídeos de origen de 2 a 30 segundos y hasta cinco imágenes opcionales de fotogramas clave situadas en marcas de tiempo especificadas. Mantenga cada imagen guía asociada a su punto previsto en el original y utilice un número pequeño de cambios claros, en lugar de un conjunto de objetivos visuales contradictorios. Aleph 2.0 es distinto del modelo anterior Gen-4 Aleph; el fabricante identifica por separado su modelo de API. Una edición guiada por fotogramas clave también es distinta de pedir a un modelo de texto a vídeo que cree un plano sin relación.
Las reglas documentadas de preparación de Edit Studio utilizan relaciones de aspecto convencionales, resolución de origen entre 480p y 1080p y 24–30 fotogramas por segundo, con un máximo de diez cortes o cambios de plano. Recomiendan material de origen de 720p o 1080p; en esa interfaz, el material de más de 30 fps se remuestrea a una tasa inferior y las cargas de más de 30 segundos se recortan. Son las reglas de preparación del flujo de edición del fabricante. Elija un segmento de origen que muestre el acontecimiento completo que desea editar y cuyo sujeto permanezca visible donde deba mantenerse el cambio.
El modelo puede propagar un fondo, ropa, objeto, luz o estilo modificados a lo largo del material. Una instrucción de movimiento adicional es útil cuando la edición necesita una acción nueva que no está en el original y que no se deduce solo del fotograma clave, como un efecto visual que se desarrolla en el tiempo. Muchas ediciones no necesitan un encargo adicional de movimiento, porque el modelo anima el ajuste del fotograma clave dentro de la escena existente. Describa específicamente un movimiento nuevo y manténgalo separado del cambio visual que ya establece el fotograma clave.
El flujo de edición del fabricante aplica de forma predeterminada una edición a todo el vídeo y puede limitarla a un intervalo seleccionado de la línea de tiempo. Conserve el clip original para comparar el resultado seleccionado con la fuente y utilizarlo en un ajuste posterior específico. Una revisión práctica va más allá del fotograma elegido: compruebe el principio, el medio, el final, cualquier corte y el periodo en que el objetivo queda brevemente oculto. El recurso útil es un clip revisado cuya transformación solicitada se mantiene coherente en el tiempo mientras los elementos importantes sin cambios conservan su función.
MP4 es el recurso predeterminado para reproducción y difusión. El flujo de vídeo completo de Edit Studio de Runway que cumple los requisitos también ofrece ProRes como archivo MOV con audio PCM o un ZIP de fotogramas PNG individuales para composición. Los perfiles ProRes van de 422 Proxy a 4444 XQ. Las ediciones limitadas a un intervalo de la línea de tiempo devuelven MP4, y el formato de salida se elige al iniciar la generación, en lugar de cambiarse tras el resultado terminado. Seleccione la forma de exportación del fabricante según la tarea posterior de edición y manténgala separada de la capacidad central del modelo de edición visual.
Para una edición terminada útil, compare la sustitución, iluminación o estilo previstos con el fotograma clave y examine los detalles circundantes que no debían cambiar. Conserve la versión que funcione y modifique la instrucción específica o el fotograma guía responsable de una discrepancia. La función de Aleph 2.0 es transformar material de origen mediante un objetivo visual claro; producir una banda sonora nueva, cambiar el comportamiento de una aplicación o completar un flujo independiente de entrega para emisión son tareas adicionales alrededor del vídeo editado.
Ailoot Ultra · Vídeo POST /v1/videos runway/aleph-2
runway/aleph-2Primeros pasos
Aleph 2.0 edita vídeos existentes mediante instrucciones de texto específicas y orientación por fotogramas clave. Utilícelo para sustituir un objeto o cambiar el fondo, el vestuario, la iluminación o el estilo, indicando qué detalles de la escena original deben mantenerse intactos.
- Entradas aceptadas
- Texto · Imágenes · Audio · Vídeo
- Resultados
- Vídeo
Disponible en Ailoot · entradas y métodos
Ailoot Ultra · Vídeo POST /v1/videos
- Tipos de entrada
text,image,audio,video- Tipos de salida
video
| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites runway/aleph-2 | Predeterminado— |
Campoinput_references | Tipoarray | RequisitoObligatorio | Valores y límites Número mínimo de elementos: 1 Número máximo de elementos: 1 | Predeterminado— |
Campoprompt | Tipostring | RequisitoObligatorio | Valores y límites Longitud mínima: 1 | Predeterminado— |
Parámetros del método y ciclo de vida
| Parámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratomodel, input_references, prompt |
Parámetromaterial_types | Contratotext, image, audio, video |
Parámetromaterial_conditions | ContratoUsa exactamente una URL de contenido real de un recurso de vídeo completado bajo tu titularidad, con la firma devuelta. La titularidad del recurso, su tipo y la evidencia de bytes almacenada deben coincidir con la solicitud. |
Ciclo de vida: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · id o polling_url real devuelto
GET /v1/videos/{request_id}/content
Planes
Cómo se calcula el cargo definitivo
Las tarifas mostradas estiman el coste antes de la generación. El cargo final se calcula a partir del coste registrado para la generación original. La duración medida del resultado y las cantidades previstas no constituyen la cantidad facturable final.
Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.
- Modo rápido
- Sin especificar Cuando se selecciona el modo rápido
- Modo flex
- Sin especificar Cuando se selecciona el modo flex
- Esfuerzo máximo de razonamiento
- Sin especificar Cuando el esfuerzo máximo de razonamiento utiliza el ajuste predeterminado (default)
Tarifas estimadas para comparar
Precios por configuración
Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas. Aplica la regla de cargo mínimo indicada para esa configuración.
| Configuración | Tabla de tarifas | Cantidad prevista | Componente del cargo | Unidad de facturación | Condiciones de facturación | Regla de cargo mínimo | Cargo |
|---|---|---|---|---|---|---|---|
| ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | Cantidad prevista— | Componente del cargo— | Unidad de facturación— | Condiciones de facturación— | Regla de cargo mínimo— | Cargo Entrada · Tokens de entrada · Estimación solo para comparar — / 1K tokens Salida · Tokens de salida · Estimación solo para comparar — / 1K tokens Entrada · Lectura de caché · Estimación solo para comparar — / 1K tokens Entrada · Escritura en caché · Estimación solo para comparar — / 1K tokens Entrada · Escritura en caché, 1 hora · Estimación solo para comparar — / 1K tokens |
| ConfiguraciónPrecio del vídeo | Tabla de tarifas— | Cantidad prevista— | Componente del cargo— | Unidad de facturaciónpor segundo de vídeo | Condiciones de facturaciónNo se declara ninguna condición adicional en esta clave de precios. | Regla de cargo mínimo— | Cargo Salida · Precio del vídeo · Estimación solo para comparar $0.56 por segundo de vídeo |
| ConfiguraciónMínimo por generación | Tabla de tarifas— | Cantidad prevista— | Componente del cargoCargo mínimo | Unidad de facturacióncargo mínimo de generación | Condiciones de facturaciónNo se declara ninguna condición adicional en esta clave de precios. | Regla de cargo mínimoSí | Cargo total · Importe mínimo por generación · Estimación solo para comparar $1.12 cargo mínimo de generación Cargo mínimo por generación; aplícalo como un mínimo, no como una comisión adicional. No implica una duración mínima. |
| ConfiguraciónCoste estimado de generación | Tabla de tarifas— | Cantidad previstaestimación para una generación | Componente del cargo— | Unidad de facturación— | Condiciones de facturación— | Regla de cargo mínimo— | Cargo Salida · Coste estimado de generación · Estimación solo para comparar $0.56 estimación previa a la generación Esta estimación no es un cargo adicional ni una tarifa fija para la generación completada. |
Ailoot reserva un importe estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. Cómo funcionan la reserva y la liquidación →
Solicitudes de ejemplo
Ailoot Ultra · Vídeo
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_INPUT_REFERENCES_JSON:?Set the actual documented input value}"
export AILOOT_INPUT_REFERENCES_JSON
: "${AILOOT_PROMPT:?Set the actual documented input value}"
export AILOOT_PROMPT
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'runway/aleph-2', 'input_references': '${ACTUAL_OWNED_INPUT_REFERENCES}', 'prompt': '${ACTUAL_EDIT_PROMPT}'}
request['input_references']=json.loads(os.environ['AILOOT_INPUT_REFERENCES_JSON'])
request['prompt']=os.environ['AILOOT_PROMPT']
Path('request.json').write_text(json.dumps(request,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o response.bin
# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.
Recibir y guardar resultados
Ailoot Ultra · Vídeo
GET /v1/videos/{request_id}GET /v1/videos/{request_id}/content
Guarda todos los archivos completados
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")
urls=[]
for x in r["data"]:
if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
u=urljoin("https://api.ailoot.ai",x)
z=urlsplit(u)
if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")
urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
index=$((index + 1))
done < asset-urls.txt
Conserva todos los resultados completados
Guarda todos los vídeos completados o archivos recibidos; descarga cada URL de archivo que se haya devuelto.
Conserva la respuesta completa y las cabeceras, todas las salidas reales, los identificadores originales devueltos y todos los campos de uso. Recupera la operación original sin volver a enviar la solicitud de creación.
Si es necesario revisar la respuesta original
Conserva X-Client-Request-ID, X-Ailoot-Task-Id y los valores reales devueltos de id/polling_url. Continúa el trabajo original; no vuelvas a enviar la solicitud de creación.
Campos de respuesta
| Campo | Tipo |
|---|---|
Campoid | Tipo |
Campostatus | Tipo |
Campodata[] | Tipo |
Campooutputs[] | Tipo |
Alias
Alias del modelo
Ailoot Ultra runway/aleph-2
Alias de rutas de métodos
Usa las rutas de método indicadas arriba.
ID de modelo relacionados
FAQ · Runway: Aleph 2.0
- ¿Qué entradas y resultados están disponibles?
POST /v1/videos·runway/aleph-2:text,image,audio,video→video- ¿Qué campos utiliza la solicitud?
POST /v1/videos·runway/aleph-2:model,input_references,prompt