Skip to main content
POST
cURL
Use aleph2 para editar un video de origen con un prompt de texto. La solicitud devuelve una tarea id; recupere los detalles de la tarea para obtener el resultado final.

Prepare la solicitud

  • Autentíquese con su clave de API de CometAPI.
  • Establezca model en aleph2 y proporcione videoUri para un video de hasta 30 segundos.
  • Opcional: incluya promptText para describir la edición, con entre 1 y 1000 caracteres. También puede omitirlo al usar fotogramas clave.
  • Reemplace la URL de medios de ejemplo por una URL HTTPS accesible. Los campos de medios también aceptan URI de datos Base64 con un tamaño codificado de hasta 5 MB.

Agregue imágenes de guía temporizadas

Para guiar momentos específicos, proporcione de uno a cinco objetos en keyframes. Cada objeto contiene una uri de imagen y exactamente una posición: La marca de tiempo del fotograma clave debe estar dentro de su ventana de edición. Si usa range, establézcalo en cada fotograma clave. De lo contrario, omita range de cada fotograma clave. Omita keyframes cuando no necesite imágenes de guía. Un arreglo vacío o null se considera una omisión.

Elija la forma y el formato del fotograma

Use targetAspectRatio para solicitar la expansión a 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16o 21:9. Al video de entrada y a las imágenes de guía se les añaden bandas negras para ajustarlos a esta forma antes de la generación. El campo obsoleto es opcional; use ratio para controlar la relación de aspecto. Salida: use targetAspectRatio para controlar la relación de aspecto. Si outputFormat es prores, puede establecer proresProfile en 422, 4444, 422 Proxy, 422 LT, 422 HQo 4444 XQ. El perfil predeterminado es 4444. El canal alfa de 4444 y 4444 XQ es opaco. Omita proresProfile para otros formatos de salida. Para una semilla de muestreo explícita, use 1 hasta 4294967295. Omita seed para una semilla aleatoria; 0 se considera una omisión.

Recupere el resultado

Guarde el id devuelto y use Obtener una tarea de Runway para recuperar el estado de la tarea. Cuando status sea SUCCEEDED, lea las URL de resultados de output. Si la tarea falla, inspeccione failure y failureCode cuando estén presentes.

Autorizaciones

Authorization
string
header
requerido

Your CometAPI API key.

Cuerpo

application/json

Aleph 2 video-editing request.

model
enum<string>
requerido

Model ID for this request.

Opciones disponibles:
aleph2
videoUri
requerido

Input video to edit, with a maximum duration of 30 seconds. Use an accessible HTTPS URL or a Base64 data URI with an encoded size of up to 5 MB.

Required string length: 13 - 2048
Pattern: ^https://
promptText
string

Optional instruction describing the edit, from 1 to 1,000 characters. Can be omitted when using keyframes.

Required string length: 1 - 1000
keyframes
object[] | null

One to five timed guidance images. Each image uses exactly one of seconds or at. Omit when no guidance images are needed; an empty array or null is treated as omission.

Maximum array length: 5

Guidance image positioned using seconds.

targetAspectRatio
enum<string>

Target aspect ratio for expansion. The input video and keyframes are letterboxed to this shape before generation.

Opciones disponibles:
16:9,
4:3,
3:2,
1:1,
2:3,
3:4,
9:16,
21:9
ratio
string
obsoleto

Deprecated aspect-ratio field. Use targetAspectRatio instead.

seed
integer

Sampling seed. Omit for a random seed; 0 is treated as omission.

Rango requerido: 0 <= x <= 4294967295
outputFormat
enum<string>

Output format: mp4 for H.264 MP4, prores for ProRes MOV, png_sequence for a ZIP of PNG frames, or sdr_rec709_10bit for 10-bit Rec.709 HEVC MP4. Omit for mp4.

Opciones disponibles:
mp4,
prores,
png_sequence,
sdr_rec709_10bit
proresProfile
enum<string>

ProRes profile. Include only with outputFormat set to prores; omit for 4444. The 4444 and 4444 XQ profiles have an opaque alpha channel.

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

Content moderation settings. Omit to use the standard settings.

Respuesta

The task was created. Save its id for task retrieval.

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