Skip to main content
POST
cURL
Use gen4.5 para generar un vídeo a partir de un Prompt de texto. Envíe su API de CometAPI key con autenticación Bearer y un cuerpo de solicitud JSON.

Prepare la solicitud

  • Establezca model en gen4.5.
  • Describa la escena y el movimiento en promptText, usando de 1 a 1000 unidades de código UTF-16.
  • Establezca ratio en 1280:720 para orientación horizontal o en 720:1280 para orientación vertical.
  • Establezca duration en un número entero de entre 2 y 10 segundos.
Los cuatro campos son obligatorios. Para comenzar a partir de una imagen, use Crear una tarea de imagen a vídeo de Runway. No incluya promptImage ni un interruptor audio en esta solicitud de texto a vídeo.

Establezca controles opcionales

Para una semilla de muestreo explícita, use de 1 a 4294967295. La omisión o 0 selecciona una semilla aleatoria. Si incluye contentModeration, establezca su publicFigureThreshold en auto o low; de lo contrario, omita el objeto. Use outputFormat para seleccionar MP4, ProRes, secuencias PNG o uno de los formatos HDR enumerados en el esquema de la solicitud. Omítalo para H.264 MP4. Puede establecer proresProfile solo cuando outputFormat sea prores o hdr_prores. El formato HDR ProRes acepta 422, 422 HQ o 4444.

Recupere el resultado

Guarde el id devuelto y use Obtener una tarea de Runway. Cuando status sea SUCCEEDED, lea las URL de vídeo en output.

Autorizaciones

Authorization
string
header
requerido

Use your CometAPI API key.

Cuerpo

application/json

Request parameters for gen4.5.

model
enum<string>
requerido

Model ID for this request variant.

Opciones disponibles:
gen4.5
Allowed value: "gen4.5"
promptText
string
requerido

Describe the requested scene or motion in 1 to 1,000 UTF-16 code units.

Required string length: 1 - 1000
ratio
enum<string>
requerido

Requested output dimensions, expressed as width:height. Choose a value listed for this model and endpoint.

Opciones disponibles:
1280:720,
720:1280
duration
integer
requerido

Requested video duration in whole seconds, from 2 through 10.

Rango requerido: 2 <= x <= 10
seed
integer

Optional sampling seed. Use a positive integer for an explicit seed. Omission or 0 selects a random seed.

Rango requerido: 0 <= x <= 4294967295
contentModeration
object

Optional content moderation settings. Omit the object to use standard moderation.

outputFormat
enum<string>

Output encoding. Omit for mp4 (H.264). prores returns MOV; png_sequence returns a PNG ZIP; sdr_rec709_10bit returns 10-bit Rec.709 HEVC. hdr10 and hlg return 10-bit HDR MP4; hdr_pq_12bit_master returns 12-bit HEVC MOV; hdr_prores returns HDR ProRes MOV. The HDR PNG/EXR sequence formats return ZIP archives; the ACEScg variants target the named ACES version.

Opciones disponibles:
mp4,
prores,
png_sequence,
hdr10,
hlg,
sdr_rec709_10bit,
hdr_pq_12bit_master,
hdr_prores,
hdr_png_sequence,
hdr_exr_sequence,
hdr_exr_acescg_sequence_1_3,
hdr_exr_acescg_sequence_2_0
proresProfile
enum<string>

Profile for outputFormat prores or hdr_prores. Omit for 4444 with prores, or 422 HQ with hdr_prores. hdr_prores accepts only 422, 422 HQ, or 4444. Omit this field for other formats.

Opciones disponibles:
422,
4444,
422 Proxy,
422 LT,
422 HQ,
4444 XQ

Respuesta

Task submitted. Save its id to retrieve task status.

id
string
requerido

Task ID for GET /runwayml/v1/tasks/{id}.

status
string

Task state, when returned.

createdAt
string<date-time>

Task submission timestamp, when returned.

output
string<uri>[]

Result URLs, when returned.

failure
string

Failure explanation, when returned.

failureCode
string

Machine-readable failure code, when returned.

estimatedCost
object

Task estimate metadata, when returned.

cost
object

Task cost metadata, when returned.

Última modificación el 18 de septiembre de 2026