Skip to main content
POST
Utilisez ce endpoint pour animer une image source. Envoyez votre clé API CometAPI avec une authentification Bearer et un corps de requête JSON.

Choisir un modèle

Pour une requête utilisant uniquement du texte, utilisez Créer une tâche Runway de conversion de texte en vidéo.

Fournir la première image

Définissez promptImage sur une URL d’image HTTPS accessible ou un URI de données d’image Base64. Vous pouvez également fournir un tableau contenant un seul élément avec uri et position: "first". Cette interface accepte une image de départ ; n’ajoutez pas d’entrée pour la dernière image. Les images HTTPS doivent être directement accessibles sans redirection et comporter des en-têtes de contenu d’image valides. Les URI de données d’image encodées peuvent atteindre 5 Mo. Consultez les exigences relatives aux entrées média Runway pour connaître les formats et dimensions d’image.

Définir la durée et les dimensions

Utilisez une valeur entière duration comprise entre 2 et 10 secondes. Ce champ est obligatoire pour gen4.5 et facultatif pour gen4_turbo. Définissez ratio sur 1280:720, 720:1280, 1104:832, 960:960, 832:1104 ou 1584:672. Il s’agit de valeurs de largeur et de hauteur séparées par deux-points. Pour spécifier une graine d’échantillonnage explicite, utilisez 1 à 4294967295. L’omission ou 0 sélectionne une graine aléatoire. Si vous incluez contentModeration, définissez sa publicFigureThreshold sur auto ou low ; sinon, omettez l’objet.

Choisir un format de sortie

gen4.5 accepte outputFormat pour les séquences MP4, ProRes, PNG et les formats HDR répertoriés dans le schéma de la requête. Omettez ce champ pour H.264 MP4. proresProfile s’applique uniquement à prores et hdr_prores ; ses valeurs autorisées dépendent du format sélectionné. Omettez les deux champs avec gen4_turbo.

Récupérer le résultat

Enregistrez la valeur id renvoyée et utilisez Obtenir une tâche Runway. Lorsque status est égal à SUCCEEDED, lisez les URL de résultat dans output.

Autorisations

Authorization
string
header
requis

Use your CometAPI API key.

Corps

application/json

Request parameters for gen4.5.

model
enum<string>
requis

Model ID for this request variant.

Options disponibles:
gen4.5
Allowed value: "gen4.5"
promptText
string
requis

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

Required string length: 1 - 1000
promptImage
requis

Image to use as the first frame. Supply a media URI or a one-item array with position set to first.

Maximum string length: 2048
Pattern: ^https://
ratio
enum<string>
requis

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

Options disponibles:
1280:720,
720:1280,
1104:832,
960:960,
832:1104,
1584:672
duration
integer
requis

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

Plage requise: 2 <= x <= 10
seed
integer

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

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

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

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

Réponse

Task submitted. Save its id to retrieve task status.

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