Skip to main content
POST
cURL
Utilisez gen4.5 pour générer une vidéo à partir d’un Prompt textuel. Envoyez votre clé d’API CometAPI avec l’authentification Bearer et un corps de requête JSON.

Préparer la requête

  • Définissez model sur gen4.5.
  • Décrivez la scène et le mouvement dans promptText, en utilisant de 1 à 1 000 unités de code UTF-16.
  • Définissez ratio sur 1280:720 pour le format paysage ou sur 720:1280 pour le format portrait.
  • Définissez duration sur un nombre entier de 2 à 10 secondes.
Les quatre champs sont obligatoires. Pour démarrer à partir d’une image, utilisez Créer une tâche Runway image-to-video. N’incluez pas promptImage ni de bascule audio dans cette requête text-to-video.

Définir les contrôles facultatifs

Pour une graine d’échantillonnage explicite, utilisez une valeur comprise entre 1 et 4294967295. L’omission de ce champ ou la valeur 0 sélectionne une graine aléatoire. Si vous incluez contentModeration, définissez son publicFigureThreshold sur auto ou low ; sinon, omettez l’objet. Utilisez outputFormat pour sélectionner MP4, ProRes, des séquences PNG ou l’un des formats HDR répertoriés dans le schéma de requête. Omettez-le pour H.264 MP4. Vous ne pouvez définir proresProfile que lorsque outputFormat est défini sur prores ou hdr_prores. Le format HDR ProRes accepte 422, 422 HQ ou 4444.

Récupérer le résultat

Enregistrez le id renvoyé et utilisez Obtenir une tâche Runway. Lorsque status est SUCCEEDED, récupérez les URL de la vidéo 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
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
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 21 septembre 2026