Skip to main content
POST
cURL
Utilisez 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 model sur aleph2 et fournissez videoUri pour une vidéo d’une durée maximale de 30 secondes.
  • Incluez un promptText non 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 dans keyframes. Chaque objet contient une uri d’image et exactement une position : L’horodatage de l’image clé doit se situer dans sa fenêtre de modification. Si vous utilisez 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

Utilisez targetAspectRatio 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. Si 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 le id 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

Authorization
string
header
requis

Your CometAPI API key.

Corps

application/json

Aleph 2 video-editing request.

model
enum<string>
requis

Model ID for this request.

Options disponibles:
aleph2
videoUri
requis

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
requis

Describe the change to make to the video. Required even when keyframes are supplied.

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.

Options disponibles:
16:9,
4:3,
3:2,
1:1,
2:3,
3:4,
9:16,
21:9
ratio
string
obsolète

Deprecated aspect-ratio field. Use targetAspectRatio instead.

seed
integer

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

Plage requise: 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.

Options 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.

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

Content moderation settings. Omit to use the standard settings.

Réponse

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

id
string
requis

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.

Dernière modification le 18 septembre 2026