Crear una tarea de video a video de Runway
Edite un video con Runway Aleph 2 mediante CometAPI, usando un prompt de texto, imágenes de guía temporizadas y una relación de aspecto de destino opcional.
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
modelenaleph2y proporcionevideoUripara un video de hasta 30 segundos. - Opcional: incluya
promptTextpara 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 enkeyframes.
Cada objeto contiene una uri de imagen y exactamente una posición:
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
UsetargetAspectRatio 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.
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 elid 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
Your CometAPI API key.
Cuerpo
Aleph 2 video-editing request.
Model ID for this request.
aleph2 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.
13 - 2048^https://Optional instruction describing the edit, from 1 to 1,000 characters. Can be omitted when using keyframes.
1 - 1000One 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.
5Guidance image positioned using seconds.
- Option 1
- Option 2
Target aspect ratio for expansion. The input video and keyframes are letterboxed to this shape before generation.
16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 21:9 Deprecated aspect-ratio field. Use targetAspectRatio instead.
Sampling seed. Omit for a random seed; 0 is treated as omission.
0 <= x <= 4294967295Output 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.
mp4, prores, png_sequence, sdr_rec709_10bit ProRes profile. Include only with outputFormat set to prores; omit for 4444. The 4444 and 4444 XQ profiles have an opaque alpha channel.
422, 4444, 422 Proxy, 422 LT, 422 HQ, 4444 XQ Content moderation settings. Omit to use the standard settings.
Respuesta
The task was created. Save its id for task retrieval.
Task ID for GET /runwayml/v1/tasks/{id}.
Task state, when returned.
Task submission timestamp, when returned.
Result URLs, when returned.
Failure explanation, when returned.
Machine-readable failure code, when returned.
Task estimate metadata, when returned.
Task cost metadata, when returned.