Runway: Gen-4.5
Runway Gen-4.5 crea vídeos a partir de una descripción de escena o una imagen con indicaciones de movimiento. Sus clips de 2–10 segundos, las instrucciones explícitas de cámara y las opciones de composición diferenciadas de texto a vídeo e imagen a vídeo sirven para conceptos cinematográficos, planos de recurso y escenas visuales animadas.
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.
Runway Gen-4.5 es un modelo de generación de vídeo con modos de texto a vídeo e imagen a vídeo. Puede seguir un encargo que describa la composición de la escena, la acción del sujeto, la coreografía de cámara y una secuencia de acontecimientos. El resultado útil es un plano corto generado que puede revisarse, conservarse o montarse con otro material.
Elegir el modo de entrada para el plano
Texto a vídeo parte de una descripción escrita de la escena. Incluya tanto el contenido visible como el movimiento: sujeto, escenario, iluminación, encuadre, acción y comportamiento de cámara. Este modo resulta útil para una escena nueva, planos de recurso, un fondo o un concepto visual cuyo fotograma inicial no tenga que reproducir una imagen proporcionada.
Imagen a vídeo parte de una imagen que actúa como primer fotograma. Esa imagen aporta composición, contenido, iluminación y estilo. Centre la instrucción escrita en lo que debe ocurrir después: la acción del sujeto, el movimiento del entorno, el movimiento de cámara y la progresión del plano.
Prepare una imagen clara con los detalles importantes ya visibles. Los rostros, manos u otros elementos borrosos o con artefactos pueden resultar más notorios al animarse. Una referencia que sugiera movimiento rápido mediante polvo o desenfoque de movimiento también puede entrar en conflicto con una instrucción que pida un sujeto inmóvil.
Describir directamente la imagen y el movimiento
Utilice lenguaje natural claro y descripciones positivas del resultado previsto. Un encargo de texto a vídeo puede indicar primero la vista de cámara, el sujeto y la acción, y después añadir el tratamiento de la escena. Una descripción detallada es útil cuando el plano tiene requisitos definidos; una más sencilla deja más margen para explorar. No existe un número ideal de palabras que sustituya a la claridad.
Por ejemplo, describa una vista cercana de una lámpara de escritorio de latón al encenderse, seguida de un movimiento lento de cámara que revele un cuaderno a su lado. Indique los materiales visibles y la luz para texto a vídeo. Si una imagen proporcionada ya establece esos detalles, la instrucción de imagen a vídeo puede concentrarse en el cambio de luz y en lo que revela la cámara.
Evite indicaciones contradictorias. Una vista de cámara fija con movimiento sutil del sujeto es distinta de un seguimiento enérgico con cámara en mano. Añada los detalles que definen el plano útil, en lugar de una lista larga de estilos visuales sin relación.
Términos de cámara y acción secuenciada
La guía de cámara del fabricante distingue encuadre, ángulos, movimiento y enfoque. Un primer plano cambia lo que llena el encuadre, un contrapicado cambia la perspectiva, una panorámica gira la vista de cámara y un travelling de seguimiento acompaña al sujeto. Una instrucción de cambio de foco desplaza el enfoque entre sujetos visibles. Indique qué debe verse o revelarse a medida que se desarrolla el movimiento.
Las instrucciones secuenciales pueden expresar acontecimientos en lenguaje habitual o con marcas de tiempo aproximadas. Estas marcas orientan el orden y la sincronización aproximada; no garantizan una ejecución exacta por fotograma. Dé a las acciones solicitadas tiempo suficiente para suceder de forma natural dentro de la duración seleccionada del clip.
Para un plano estático, describa el movimiento que debe ocurrir dentro del encuadre y refuerce la cámara inmóvil prevista. El fabricante señala que las vistas completamente inmóviles pueden ser difíciles, especialmente en algunos planos amplios o de situación. Revise los pequeños movimientos no deseados en el resultado real, en lugar de asumir que una frase de cámara estática los hace imposibles.
Duración, dimensiones y fotogramas por segundo
Gen-4.5 admite duraciones de clip de 2 a 10 segundos. Una opción más larga puede acomodar varias acciones ordenadas, mientras que una reacción o revelación breve puede utilizar un plano más corto. Su salida documentada es de 720p, con 24 o 25 fotogramas por segundo en el flujo de generación del fabricante.
La especificación de texto a vídeo enumera 16:9 a 1280 × 720 píxeles. Imagen a vídeo añade 9:16 a 720 × 1280, 1:1 a 960 × 960, 4:3 a 1104 × 832, 3:4 a 832 × 1104 y 21:9 a 1584 × 672. Mantenga unidos el modo y las dimensiones reales, en lugar de asumir que ambos modos de entrada ofrecen el mismo conjunto de relaciones de aspecto.
La relación de una imagen puede establecer la composición predeterminada y cambiarla puede recortar la entrada. Compruebe la posición del sujeto antes de juzgar el movimiento: una acción correcta no es útil si se ha recortado una parte clave de la imagen de origen.
Construir una secuencia más larga a partir de planos completados
Para trabajos basados en imagen, el fabricante describe continuar una secuencia utilizando el último fotograma de un clip completado como entrada de imagen de otra generación. Después se combinan los clips en un editor de vídeo, gestionando en la edición su fotograma compartido y la sincronización. Es una secuencia de planos independientes, no una generación de duración ilimitada.
Conserve el fotograma final y el encargo correspondiente para que el siguiente plano comience desde el estado visual previsto. Examine la continuidad en el material unido, incluidos el aspecto del sujeto, la dirección de cámara y la transición entre clips.
Conservar y revisar el recurso de producción
Tras la generación, revise el clip completo y conserve la salida terminada. El flujo del fabricante también proporciona opciones independientes de ampliación y exportación de producción, como ProRes o una secuencia PNG. Son opciones adicionales del flujo; las dimensiones nativas de generación siguen siendo distintas de un resultado ampliado posteriormente.
Utilice Gen-4.5 para conceptos cinematográficos, ideas visuales animadas, planos de recurso y desarrollo de escenas breves. Conserve juntos la instrucción, la imagen de entrada si se utiliza, la duración, el modo y el clip devuelto. Compruebe el orden de las acciones, el comportamiento de cámara, los detalles del sujeto, los cortes no deseados y el encuadre previsto, y después realice una corrección específica del plano.
Ailoot Ultra · Vídeo POST /v1/videos runway/gen-4.5
runway/gen-4.5Primeros pasos
Runway Gen-4.5 crea vídeos a partir de una descripción de escena o una imagen con indicaciones de movimiento. Sus clips de 2–10 segundos, las instrucciones explícitas de cámara y las opciones de composición diferenciadas de texto a vídeo e imagen a vídeo sirven para conceptos cinematográficos, planos de recurso y escenas visuales animadas.
- Entradas aceptadas
- Texto · Imágenes
- Resultados
- Vídeo
Disponible en Ailoot · entradas y métodos
Ailoot Ultra · Vídeo POST /v1/videos
- Tipos de entrada
text,image- Tipos de salida
video- Formato de salida
- bytes MP4 originales; sin normalización ni transcodificación
| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites runway/gen-4.5 | Predeterminado— |
Campoprompt | Tipostring | RequisitoObligatorio | Valores y límites | Predeterminado— |
Campoduration | Tipointeger | RequisitoObligatorio | Valores y límites 2, 3, 4, 5, 6, 7, 8, 9, 10 Mínimo: 1 Máximo: 600 | Predeterminado— |
Camporesolution | Tipostring | RequisitoOpcional | Valores y límites 720p | Predeterminado— |
Campoaspect_ratio | Tipostring | RequisitoOpcional | Valores y límites 16:9, 9:16 | Predeterminado— |
Campogenerate_audio | Tipoboolean | RequisitoOpcional | Valores y límites false | Predeterminado— |
Campoframe_images | Tipoarray | RequisitoOpcional | Valores y límites Número mínimo de elementos: 1 Número máximo de elementos: 1 Contenido de entrada: Lista de objetos de fotograma. Cada objeto contiene type=image_url, image_url con url y frame_type. Usa una URL HTTPS de imagen y establece frame_type en first_frame. Cada función de fotograma aparece como máximo una vez. Claves exactas: type, image_url, frame_type Condiciones: Estas claves describen cada objeto de fotograma; image_url solo contiene url. Omite frame_images para una solicitud que solo contenga texto. | Predeterminado— |
Campoinput_references | Tipoarray | RequisitoOpcional | Valores y límites | Predeterminado— |
Camposize | Tipostring | RequisitoOpcional | Valores y límites 1280x720, 720x1280 Patrón: ^[1-9][0-9]*x[1-9][0-9]*$ | Predeterminado— |
Camposeed | Tipointeger | RequisitoOpcional | Valores y límites Mínimo: -9.223.372.036.854.775.808 Máximo: 9.223.372.036.854.775.807 | Predeterminado— |
Campocallback_url | Tipostring | RequisitoOpcional | Valores y límites Patrón: ^https:// | Predeterminado— |
Camposession_id | Tipostring | RequisitoOpcional | Valores y límites | Predeterminado— |
Campotrace | Tipoobject | RequisitoOpcional | Valores y límites | Predeterminado— |
Campouser | Tipostring | RequisitoOpcional | Valores y límites | Predeterminado— |
Combinaciones de materiales de entrada
Texto a vídeo · Una instrucción escrita. · Obligatorio: model, prompt, duration
Proporciona prompt como texto y duration en segundos enteros. Elige una resolución compatible; añade una relación de aspecto o usa un tamaño enumerado.
model: Tipo: string · runway/gen-4.5
prompt: Tipo: string · Máximo de bytes UTF-8: 10.000 · Se requiere contenido distinto de espacios en blanco: Sí
Imagen a vídeo · Una instrucción escrita y una imagen del primer fotograma. · Obligatorio: model, prompt, duration, frame_images
frame_images es una lista. Cada objeto de fotograma incluye type, image_url y frame_type; image_url contiene url. Establece type en image_url. Usa first_frame. Cada función de fotograma aparece como máximo una vez. Proporciona una URL HTTPS pública de imagen para cada fotograma. Elige una resolución compatible; añade una relación de aspecto o usa un tamaño enumerado.
Claves exactas: type, image_url, frame_type
model: Tipo: string · runway/gen-4.5
prompt: Tipo: string · Máximo de bytes UTF-8: 10.000 · Se requiere contenido distinto de espacios en blanco: Sí
Parámetros del método y ciclo de vida
| Parámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratomodel, prompt, duration |
Parámetromaterial_types | Contratotext, image |
Parámetroadditional_properties | Contratofalse |
Parámetrooptional_controls | Contratoresolution, aspect_ratio, generate_audio, frame_images, input_references, size, seed, callback_url, session_id, trace, user |
Ciclo de vida: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_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.
| Configuración | Tabla de tarifas | Cantidad prevista | Unidad de facturación | Condiciones de facturación | Cargo |
|---|---|---|---|---|---|
| ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | Cantidad prevista— | Unidad de facturación— | Condiciones de facturación— | 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— | Unidad de facturaciónpor segundo de vídeo | Condiciones de facturaciónNo se declara ninguna condición adicional en esta clave de precios. | Cargo Salida · Precio del vídeo · Estimación solo para comparar $0.24 por segundo de vídeo |
| ConfiguraciónCoste estimado de generación | Tabla de tarifas— | Cantidad previstaestimación para una generación | Unidad de facturación— | Condiciones de facturación— | Cargo Salida · Coste estimado de generación · Estimación solo para comparar $0.48 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 →
Detalles de la tarifa de referencia
Las tablas de referencia del modelo no cambian la selección del método, las estimaciones de coste ni los cargos. Los cargos aplicados usan las tarifas del método Ailoot seleccionado.
Referencias de precios de configuraciones de vídeo
Precios por configuración
| Configuración | Condiciones de facturación | Cargo |
|---|---|---|
| ConfiguraciónPrecio del vídeo | Condiciones de facturaciónNo se declara ninguna condición adicional en esta clave de precios. | Cargo Salida · Precio del vídeo $0.24 por segundo de vídeo Referencia de precios publicada para la configuración mostrada. Los cargos finales se calculan según la configuración realmente facturada. |
Solicitudes de ejemplo
Ailoot Ultra · Vídeo
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"runway/gen-4.5","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', 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 result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Recibir y guardar resultados
Ailoot Ultra · Vídeo
URL firmadas de contenido bajo tu titularidad
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Consultar el estado de la tarea
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Otras consultas de contenido
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
Conserva todos los resultados completados
Guarda todos los vídeos completados o archivos recibidos; descarga cada URL de archivo que se haya devuelto.
Conserva todos los resultados reales bajo tu titularidad y los metadatos medidos que se devuelvan.
Si es necesario revisar la respuesta original
503 result_pending_check + originalid + X-Should-Retry:false; no repitas nunca la operación original
Campos de respuesta
| Campo | Tipo | Significado |
|---|---|---|
Campoindex | Tipointeger | SignificadoPosición de este vídeo en la lista de resultados, empezando por cero. |
Campocontent_url | Tipostring | SignificadoURL HTTPS firmada de descarga de este vídeo completado. |
Camposha256 | Tipostring | null | SignificadoHuella SHA-256 de los bytes del vídeo original; null si no está disponible. |
Camposize_bytes | Tipointeger | null | SignificadoTamaño del archivo de vídeo original en bytes; null si no está disponible. |
Campoduration_ms | Tipointeger | null | SignificadoDuración medida del vídeo en milisegundos; null si no está disponible. |
Campowidth | Tipointeger | null | SignificadoAnchura del vídeo en píxeles; null si no está disponible. |
Campoheight | Tipointeger | null | SignificadoAltura del vídeo en píxeles; null si no está disponible. |
Campovideo_codec | Tipostring | null | SignificadoIdentificador del códec de vídeo; null si no se ha registrado. |
Campohas_audio | Tipoboolean | null | SignificadoIndica si el vídeo contiene una pista de audio; null si no se ha medido. |
Campoaudio_codec | Tipostring | null | SignificadoIdentificador del códec de audio; null cuando no se ha registrado ninguno. |
Errores y siguientes pasos
| Respuesta | Condición | Siguiente paso |
|---|---|---|
Respuesta404 · not_found_error | CondiciónEl acceso al vídeo no está disponible o no se ha encontrado este ID de vídeo. | Siguiente pasoComprueba el acceso al vídeo. Para un vídeo existente, usa su ID público original y la misma clave API. |
Respuesta401 · authentication_error | CondiciónLa clave API no corresponde a la cuenta autenticada. | Siguiente pasoComprueba tu clave API y el acceso de tu cuenta antes de enviar la solicitud. |
Respuesta400 · invalid_request_error | CondiciónNo se ha podido leer la solicitud o el índice de descarga no es válido. | Siguiente pasoCorrige el cuerpo de la solicitud. Para una descarga, elige un índice de salida devuelto por la tarea original. |
Respuesta422 · price_unavailable | CondiciónNo se puede calcular el precio de la configuración de vídeo seleccionada. | Siguiente pasoElige una configuración de vídeo compatible y completa sus opciones obligatorias antes de enviar una solicitud corregida. |
Respuesta422 · invalid_request_error | CondiciónUna entrada de vídeo o la tarea original de continuación no es válida. | Siguiente pasoUsa entradas HTTPS válidas. Para continuar, usa el ID público de tu vídeo original completado con la misma clave API. |
Respuesta402 · billing_error | CondiciónEl saldo disponible o los límites no permiten efectuar una reserva. | Siguiente pasoComprueba tu saldo disponible y tus límites antes de enviar una nueva solicitud. |
Respuesta503 · server_error | CondiciónLa verificación del vídeo, el almacenamiento o el acceso al servicio no están disponibles temporalmente. | Siguiente pasoEspera a que el servicio esté disponible. Si ya tienes un ID de vídeo, comprueba esa tarea original en lugar de crear otra generación. |
Respuesta503 · result_pending_check | CondiciónEs necesario comprobar el resultado del vídeo original y el cargo. | Siguiente pasoConserva el ID de vídeo devuelto y comprueba esa tarea. No envíes una solicitud de generación sustitutiva mientras se esté comprobando. |
Respuesta503 · owned_result_unavailable | CondiciónLa descarga del vídeo existente no está disponible temporalmente. | Siguiente pasoComprueba más tarde la misma tarea de vídeo y descarga su resultado existente. Una nueva generación crea una operación independiente. |
Respuesta409 · video_not_ready | CondiciónEl contenido del vídeo no se ha publicado. | Siguiente pasoComprueba el estado de la tarea original. Descarga cuando indique completed; si indica failed, sigue su aviso de comprobación del cargo. |
Alias
Alias del modelo
Ailoot Ultra runway/gen-4.5
Alias de rutas de métodos
Usa las rutas de método indicadas arriba.
ID de modelo relacionados
FAQ · Runway: Gen-4.5
- ¿Qué entradas y resultados están disponibles?
POST /v1/videos·runway/gen-4.5:text,image→video- ¿Qué campos utiliza la solicitud?
POST /v1/videos·runway/gen-4.5:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,seed,callback_url,session_id,trace,user- ¿Qué límites se aplican?
POST /v1/videos·runway/gen-4.5:duration.minimum:1;duration.maximum:600;frame_images.max_items:1;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807