Créer une tâche vidéo-à-vidéo Runway
Modifiez une vidéo avec Runway Aleph 2 via CometAPI, à l’aide d’un Prompt textuel, d’images de guidage synchronisées et d’un rapport hauteur/largeur cible facultatif.
aleph2 pour modifier une vidéo source avec un Prompt textuel. La requête renvoie une
tâche id ; récupérez les détails de la tâche pour obtenir la sortie terminée.
Préparer la requête
- Authentifiez-vous avec votre clé API CometAPI.
- Définissez
modelsuraleph2et fournissezvideoUripour une vidéo d’une durée maximale de 30 secondes. - Incluez un
promptTextnon vide de 1 000 caractères maximum, y compris lorsque vous fournissez des images clés. - Remplacez l’URL de média d’exemple par une URL HTTPS accessible. Les champs multimédias acceptent également des URI de données Base64 d’une taille encodée maximale de 5 Mo.
Ajouter des images de guidage synchronisées
Pour guider certains moments, fournissez de un à cinq objets danskeyframes.
Chaque objet contient une uri d’image et exactement une position :
range,
définissez-le sur chaque image clé. Sinon, omettez range de chaque image clé.
Omettez keyframes lorsque vous n’avez pas besoin d’images de guidage. Un tableau vide ou
null est considéré comme une omission.
Choisir la forme et le format de l’image
UtiliseztargetAspectRatio pour demander une extension vers 16:9, 4:3, 3:2, 1:1,
2:3, 3:4, 9:16, ou 21:9. La vidéo d’entrée et les images de guidage sont
encadrées de bandes noires selon cette forme avant la génération. Le champ ratio obsolète
est facultatif ; utilisez targetAspectRatio pour contrôler le rapport hauteur/largeur.
outputFormat est prores, vous pouvez définir proresProfile sur 422, 4444,
422 Proxy, 422 LT, 422 HQ, ou 4444 XQ. Le profil par défaut est 4444.
Le canal alpha dans 4444 et 4444 XQ est opaque. Omettez proresProfile
pour les autres formats de sortie.
Pour une graine d’échantillonnage explicite, utilisez 1 à 4294967295. Omettez seed
pour une graine aléatoire ; 0 est considéré comme une omission.
Récupérer le résultat
Enregistrez leid renvoyé et utilisez
Obtenir une tâche Runway pour récupérer l’état de la tâche.
Lorsque status est SUCCEEDED, lisez les URL de résultat dans output. Si la tâche
échoue, inspectez failure et failureCode lorsqu’ils sont présents.Autorisations
Your CometAPI API key.
Corps
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://Describe the change to make to the video. Required even when keyframes are supplied.
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.
Réponse
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.