{ "aboutHtml": "

Runway Gen-4.5 est un modèle de génération vidéo doté de modes à partir de texte ou d’une image. Il peut suivre un brief décrivant la composition d’une scène, l’action du sujet, la chorégraphie de la caméra et une suite d’événements. Le résultat utile est un court plan généré qui peut être examiné, conservé ou assemblé avec d’autres images filmées.

Choisir le mode d’entrée du plan

La génération de vidéo à partir de texte commence par une description écrite de la scène. Précisez à la fois le contenu visible et le mouvement : sujet, décor, éclairage, cadrage, action et comportement de la caméra. Ce mode convient à une nouvelle scène, à un plan d’illustration, à un plan de fond ou à un concept visuel dont l’image initiale n’a pas à reproduire une image fournie.

La génération de vidéo à partir d’une image commence par une image qui sert de première image du clip. Elle fournit la composition, le contenu, l’éclairage et le style. Concentrez le prompt écrit sur la suite : action du sujet, mouvements dans l’environnement, mouvement de caméra et progression du plan.

Préparez une image nette où les détails importants sont déjà visibles. Les visages flous, les mains floues ou d’autres artefacts peuvent devenir plus visibles une fois animés. Une référence qui suggère un mouvement rapide par de la poussière ou du flou de mouvement peut aussi contredire un prompt demandant un sujet immobile.

Décrire directement les visuels et le mouvement

Utilisez un langage naturel clair et des descriptions positives du résultat souhaité. Un brief à partir de texte peut commencer par le point de vue de la caméra, le sujet et l’action, puis préciser le traitement de la scène. Une description détaillée est utile lorsque le plan répond à des exigences définies ; une description plus simple laisse davantage de place à l’exploration. Aucun nombre de mots idéal ne remplace la clarté.

Par exemple, décrivez une vue rapprochée d’une lampe de bureau en laiton qui s’allume, suivie d’un lent mouvement de caméra révélant un carnet à côté. Pour la génération à partir de texte, précisez les matériaux visibles et la lumière. Si une image fournie définit déjà ces détails, le prompt de génération à partir d’image peut se concentrer sur le changement de lumière et la révélation par la caméra.

Évitez les consignes contradictoires. Une vue fixe avec de légers mouvements du sujet diffère d’un travelling énergique à caméra portée. Ajoutez les détails qui définissent le plan utile plutôt qu’une longue liste de styles visuels sans rapport entre eux.

Vocabulaire de caméra et actions en séquence

Le guide de caméra du producteur distingue le cadrage, les angles, le mouvement et la mise au point. Un gros plan change ce qui remplit l’image, une contre-plongée change la perspective, un panoramique fait pivoter la vue de la caméra et un travelling d’accompagnement suit un sujet. Une consigne de bascule de point déplace la mise au point entre des sujets visibles. Précisez ce qui doit rester visible ou être révélé pendant le mouvement.

Les prompts séquentiels peuvent exprimer les événements en langage courant ou avec des repères temporels approximatifs. Ces repères guident l’ordre et les temps approximatifs ; ils ne garantissent pas une exécution à l’image près. Laissez aux actions demandées le temps de se dérouler naturellement dans la durée de clip choisie.

Pour un plan fixe, décrivez le mouvement qui doit se produire à l’intérieur de l’image et renforcez l’intention d’une caméra immobile. Le producteur indique que les vues totalement immobiles peuvent être difficiles, surtout pour certains plans larges ou d’ensemble. Examinez les petits mouvements indésirables dans le résultat réel au lieu de supposer qu’une formule demandant une caméra fixe les rend impossibles.

Durée, dimensions et fréquence d’images

Gen-4.5 prend en charge des clips de 2 à 10 secondes. Une durée plus longue peut accueillir plusieurs actions ordonnées, tandis qu’une brève réaction ou révélation peut utiliser un plan plus court. La sortie documentée est en 720p, à 24 ou 25 images par seconde dans le processus de génération du producteur.

La spécification de génération à partir de texte indique le 16:9 en 1280 × 720 pixels. La génération à partir d’image ajoute le 9:16 en 720 × 1280, le 1:1 en 960 × 960, le 4:3 en 1104 × 832, le 3:4 en 832 × 1104 et le 21:9 en 1584 × 672. Associez toujours le mode à ses dimensions réelles, au lieu de supposer que les deux modes d’entrée proposent les mêmes rapports largeur/hauteur.

Le rapport de l’image peut définir la composition par défaut, et sa modification peut recadrer l’entrée. Vérifiez l’emplacement du sujet avant de juger le mouvement : une action correcte n’est pas utile si une partie essentielle de l’image source a été coupée.

Construire une séquence plus longue à partir de plans terminés

Pour les travaux guidés par une image, le producteur décrit le prolongement d’une séquence en utilisant la dernière image d’un clip terminé comme image d’entrée d’une autre génération. Les clips sont ensuite combinés dans un logiciel de montage, où sont traités leur image commune et leurs temps. Il s’agit d’une suite de plans distincts, et non d’une génération unique de durée illimitée.

Conservez l’image finale et le brief correspondant afin que le plan suivant commence dans l’état visuel prévu. Vérifiez la continuité dans les séquences assemblées, notamment l’apparence du sujet, la direction de la caméra et la transition entre les clips.

Conserver et examiner le livrable de production

Après la génération, examinez le clip entier et conservez la sortie terminée. Le processus du producteur propose aussi des choix distincts d’agrandissement et d’export de production, tels que ProRes ou une séquence PNG. Ce sont des options supplémentaires du processus ; les dimensions natives de génération restent distinctes d’un résultat agrandi ultérieurement.

Utilisez Gen-4.5 pour des concepts cinématographiques, des idées visuelles animées, des plans d’illustration et le développement de courtes scènes. Conservez ensemble le prompt, l’image d’entrée lorsqu’elle est utilisée, la durée, le mode et le clip renvoyé. Vérifiez l’ordre des actions, le comportement de la caméra, les détails du sujet, les coupes indésirables et le cadrage souhaité, puis apportez une correction ciblée au plan.

", "aboutText": "Runway Gen-4.5 est un modèle de génération vidéo doté de modes à partir de texte ou d’une image. Il peut suivre un brief décrivant la composition d’une scène, l’action du sujet, la chorégraphie de la caméra et une suite d’événements. Le résultat utile est un court plan généré qui peut être examiné, conservé ou assemblé avec d’autres images filmées.\n\n### Choisir le mode d’entrée du plan\n\nLa génération de vidéo à partir de texte commence par une description écrite de la scène. Précisez à la fois le contenu visible et le mouvement : sujet, décor, éclairage, cadrage, action et comportement de la caméra. Ce mode convient à une nouvelle scène, à un plan d’illustration, à un plan de fond ou à un concept visuel dont l’image initiale n’a pas à reproduire une image fournie.\n\nLa génération de vidéo à partir d’une image commence par une image qui sert de première image du clip. Elle fournit la composition, le contenu, l’éclairage et le style. Concentrez le prompt écrit sur la suite : action du sujet, mouvements dans l’environnement, mouvement de caméra et progression du plan.\n\nPréparez une image nette où les détails importants sont déjà visibles. Les visages flous, les mains floues ou d’autres artefacts peuvent devenir plus visibles une fois animés. Une référence qui suggère un mouvement rapide par de la poussière ou du flou de mouvement peut aussi contredire un prompt demandant un sujet immobile.\n\n### Décrire directement les visuels et le mouvement\n\nUtilisez un langage naturel clair et des descriptions positives du résultat souhaité. Un brief à partir de texte peut commencer par le point de vue de la caméra, le sujet et l’action, puis préciser le traitement de la scène. Une description détaillée est utile lorsque le plan répond à des exigences définies ; une description plus simple laisse davantage de place à l’exploration. Aucun nombre de mots idéal ne remplace la clarté.\n\nPar exemple, décrivez une vue rapprochée d’une lampe de bureau en laiton qui s’allume, suivie d’un lent mouvement de caméra révélant un carnet à côté. Pour la génération à partir de texte, précisez les matériaux visibles et la lumière. Si une image fournie définit déjà ces détails, le prompt de génération à partir d’image peut se concentrer sur le changement de lumière et la révélation par la caméra.\n\nÉvitez les consignes contradictoires. Une vue fixe avec de légers mouvements du sujet diffère d’un travelling énergique à caméra portée. Ajoutez les détails qui définissent le plan utile plutôt qu’une longue liste de styles visuels sans rapport entre eux.\n\n### Vocabulaire de caméra et actions en séquence\n\nLe guide de caméra du producteur distingue le cadrage, les angles, le mouvement et la mise au point. Un gros plan change ce qui remplit l’image, une contre-plongée change la perspective, un panoramique fait pivoter la vue de la caméra et un travelling d’accompagnement suit un sujet. Une consigne de bascule de point déplace la mise au point entre des sujets visibles. Précisez ce qui doit rester visible ou être révélé pendant le mouvement.\n\nLes prompts séquentiels peuvent exprimer les événements en langage courant ou avec des repères temporels approximatifs. Ces repères guident l’ordre et les temps approximatifs ; ils ne garantissent pas une exécution à l’image près. Laissez aux actions demandées le temps de se dérouler naturellement dans la durée de clip choisie.\n\nPour un plan fixe, décrivez le mouvement qui doit se produire à l’intérieur de l’image et renforcez l’intention d’une caméra immobile. Le producteur indique que les vues totalement immobiles peuvent être difficiles, surtout pour certains plans larges ou d’ensemble. Examinez les petits mouvements indésirables dans le résultat réel au lieu de supposer qu’une formule demandant une caméra fixe les rend impossibles.\n\n### Durée, dimensions et fréquence d’images\n\nGen-4.5 prend en charge des clips de 2 à 10 secondes. Une durée plus longue peut accueillir plusieurs actions ordonnées, tandis qu’une brève réaction ou révélation peut utiliser un plan plus court. La sortie documentée est en 720p, à 24 ou 25 images par seconde dans le processus de génération du producteur.\n\nLa spécification de génération à partir de texte indique le 16:9 en 1280 × 720 pixels. La génération à partir d’image ajoute le 9:16 en 720 × 1280, le 1:1 en 960 × 960, le 4:3 en 1104 × 832, le 3:4 en 832 × 1104 et le 21:9 en 1584 × 672. Associez toujours le mode à ses dimensions réelles, au lieu de supposer que les deux modes d’entrée proposent les mêmes rapports largeur/hauteur.\n\nLe rapport de l’image peut définir la composition par défaut, et sa modification peut recadrer l’entrée. Vérifiez l’emplacement du sujet avant de juger le mouvement : une action correcte n’est pas utile si une partie essentielle de l’image source a été coupée.\n\n### Construire une séquence plus longue à partir de plans terminés\n\nPour les travaux guidés par une image, le producteur décrit le prolongement d’une séquence en utilisant la dernière image d’un clip terminé comme image d’entrée d’une autre génération. Les clips sont ensuite combinés dans un logiciel de montage, où sont traités leur image commune et leurs temps. Il s’agit d’une suite de plans distincts, et non d’une génération unique de durée illimitée.\n\nConservez l’image finale et le brief correspondant afin que le plan suivant commence dans l’état visuel prévu. Vérifiez la continuité dans les séquences assemblées, notamment l’apparence du sujet, la direction de la caméra et la transition entre les clips.\n\n### Conserver et examiner le livrable de production\n\nAprès la génération, examinez le clip entier et conservez la sortie terminée. Le processus du producteur propose aussi des choix distincts d’agrandissement et d’export de production, tels que ProRes ou une séquence PNG. Ce sont des options supplémentaires du processus ; les dimensions natives de génération restent distinctes d’un résultat agrandi ultérieurement.\n\nUtilisez Gen-4.5 pour des concepts cinématographiques, des idées visuelles animées, des plans d’illustration et le développement de courtes scènes. Conservez ensemble le prompt, l’image d’entrée lorsqu’elle est utilisée, la durée, le mode et le clip renvoyé. Vérifiez l’ordre des actions, le comportement de la caméra, les détails du sujet, les coupes indésirables et le cadrage souhaité, puis apportez une correction ciblée au plan.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "cbe5fe4859dfdf49037158b8f9068cb9eeb8d6dee2b70a54974390e262eb5dcc", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fr-ch", "methods": [ { "html": "
•

Runway: Gen-4.5

Runway /runway/gen-4.5

Premiers pas

Runway Gen-4.5 crée des vidéos à partir d’une description de scène ou d’une image accompagnée de consignes de mouvement. Ses clips de 2 à 10 secondes, les instructions explicites de caméra et les choix de composition distincts selon l’entrée texte ou image conviennent aux concepts cinématographiques, aux plans d’illustration et aux scènes visuelles animées.

Entrées acceptées
Texte · Images
Résultats
Vidéo
À propos du modèle

Cette description présente les capacités du modèle. Les entrées, sorties et options disponibles dans Ailoot pour la méthode sélectionnée figurent ci-dessous.

Runway Gen-4.5 est un modèle de génération vidéo doté de modes à partir de texte ou d’une image. Il peut suivre un brief décrivant la composition d’une scène, l’action du sujet, la chorégraphie de la caméra et une suite d’événements. Le résultat utile est un court plan généré qui peut être examiné, conservé ou assemblé avec d’autres images filmées.

Choisir le mode d’entrée du plan

La génération de vidéo à partir de texte commence par une description écrite de la scène. Précisez à la fois le contenu visible et le mouvement : sujet, décor, éclairage, cadrage, action et comportement de la caméra. Ce mode convient à une nouvelle scène, à un plan d’illustration, à un plan de fond ou à un concept visuel dont l’image initiale n’a pas à reproduire une image fournie.

La génération de vidéo à partir d’une image commence par une image qui sert de première image du clip. Elle fournit la composition, le contenu, l’éclairage et le style. Concentrez le prompt écrit sur la suite : action du sujet, mouvements dans l’environnement, mouvement de caméra et progression du plan.

Préparez une image nette où les détails importants sont déjà visibles. Les visages flous, les mains floues ou d’autres artefacts peuvent devenir plus visibles une fois animés. Une référence qui suggère un mouvement rapide par de la poussière ou du flou de mouvement peut aussi contredire un prompt demandant un sujet immobile.

Décrire directement les visuels et le mouvement

Utilisez un langage naturel clair et des descriptions positives du résultat souhaité. Un brief à partir de texte peut commencer par le point de vue de la caméra, le sujet et l’action, puis préciser le traitement de la scène. Une description détaillée est utile lorsque le plan répond à des exigences définies ; une description plus simple laisse davantage de place à l’exploration. Aucun nombre de mots idéal ne remplace la clarté.

Par exemple, décrivez une vue rapprochée d’une lampe de bureau en laiton qui s’allume, suivie d’un lent mouvement de caméra révélant un carnet à côté. Pour la génération à partir de texte, précisez les matériaux visibles et la lumière. Si une image fournie définit déjà ces détails, le prompt de génération à partir d’image peut se concentrer sur le changement de lumière et la révélation par la caméra.

Évitez les consignes contradictoires. Une vue fixe avec de légers mouvements du sujet diffère d’un travelling énergique à caméra portée. Ajoutez les détails qui définissent le plan utile plutôt qu’une longue liste de styles visuels sans rapport entre eux.

Vocabulaire de caméra et actions en séquence

Le guide de caméra du producteur distingue le cadrage, les angles, le mouvement et la mise au point. Un gros plan change ce qui remplit l’image, une contre-plongée change la perspective, un panoramique fait pivoter la vue de la caméra et un travelling d’accompagnement suit un sujet. Une consigne de bascule de point déplace la mise au point entre des sujets visibles. Précisez ce qui doit rester visible ou être révélé pendant le mouvement.

Les prompts séquentiels peuvent exprimer les événements en langage courant ou avec des repères temporels approximatifs. Ces repères guident l’ordre et les temps approximatifs ; ils ne garantissent pas une exécution à l’image près. Laissez aux actions demandées le temps de se dérouler naturellement dans la durée de clip choisie.

Pour un plan fixe, décrivez le mouvement qui doit se produire à l’intérieur de l’image et renforcez l’intention d’une caméra immobile. Le producteur indique que les vues totalement immobiles peuvent être difficiles, surtout pour certains plans larges ou d’ensemble. Examinez les petits mouvements indésirables dans le résultat réel au lieu de supposer qu’une formule demandant une caméra fixe les rend impossibles.

Durée, dimensions et fréquence d’images

Gen-4.5 prend en charge des clips de 2 à 10 secondes. Une durée plus longue peut accueillir plusieurs actions ordonnées, tandis qu’une brève réaction ou révélation peut utiliser un plan plus court. La sortie documentée est en 720p, à 24 ou 25 images par seconde dans le processus de génération du producteur.

La spécification de génération à partir de texte indique le 16:9 en 1280 × 720 pixels. La génération à partir d’image ajoute le 9:16 en 720 × 1280, le 1:1 en 960 × 960, le 4:3 en 1104 × 832, le 3:4 en 832 × 1104 et le 21:9 en 1584 × 672. Associez toujours le mode à ses dimensions réelles, au lieu de supposer que les deux modes d’entrée proposent les mêmes rapports largeur/hauteur.

Le rapport de l’image peut définir la composition par défaut, et sa modification peut recadrer l’entrée. Vérifiez l’emplacement du sujet avant de juger le mouvement : une action correcte n’est pas utile si une partie essentielle de l’image source a été coupée.

Construire une séquence plus longue à partir de plans terminés

Pour les travaux guidés par une image, le producteur décrit le prolongement d’une séquence en utilisant la dernière image d’un clip terminé comme image d’entrée d’une autre génération. Les clips sont ensuite combinés dans un logiciel de montage, où sont traités leur image commune et leurs temps. Il s’agit d’une suite de plans distincts, et non d’une génération unique de durée illimitée.

Conservez l’image finale et le brief correspondant afin que le plan suivant commence dans l’état visuel prévu. Vérifiez la continuité dans les séquences assemblées, notamment l’apparence du sujet, la direction de la caméra et la transition entre les clips.

Conserver et examiner le livrable de production

Après la génération, examinez le clip entier et conservez la sortie terminée. Le processus du producteur propose aussi des choix distincts d’agrandissement et d’export de production, tels que ProRes ou une séquence PNG. Ce sont des options supplémentaires du processus ; les dimensions natives de génération restent distinctes d’un résultat agrandi ultérieurement.

Utilisez Gen-4.5 pour des concepts cinématographiques, des idées visuelles animées, des plans d’illustration et le développement de courtes scènes. Conservez ensemble le prompt, l’image d’entrée lorsqu’elle est utilisée, la durée, le mode et le clip renvoyé. Vérifiez l’ordre des actions, le comportement de la caméra, les détails du sujet, les coupes indésirables et le cadrage souhaité, puis apportez une correction ciblée au plan.

Disponible dans Ailoot · entrées et méthodes

Ailoot Ultra · Vidéo POST /v1/videos
Entrée
text, image
Sortie
video
Format de sortie
Octets MP4 d’origine ; sans normalisation ni transcodage
ChampTypeExigenceValeurs et limitesPar défaut
ChampmodelTypestringExigenceObligatoireValeurs et limites
runway/gen-4.5
Par défaut—
ChamppromptTypestringExigenceObligatoireValeurs et limitesPar défaut—
ChampdurationTypeintegerExigenceObligatoireValeurs et limites
2, 3, 4, 5, 6, 7, 8, 9, 10
Minimum: 1
Maximum: 600
Par défaut—
ChampresolutionTypestringExigenceFacultatifValeurs et limites
720p
Par défaut—
Champaspect_ratioTypestringExigenceFacultatifValeurs et limites
16:9, 9:16
Par défaut—
Champgenerate_audioTypebooleanExigenceFacultatifValeurs et limites
false
Par défaut—
Champframe_imagesTypearrayExigenceFacultatifValeurs et limites
Nombre minimal d’éléments: 1
Nombre maximal d’éléments: 1
Contenu en entrée: Tableau d’objets d’image. Chaque objet contient type=image_url, image_url contenant url et frame_type. Utilisez une URL d’image HTTPS et définissez frame_type sur first_frame. Chaque rôle d’image apparaît au maximum une fois.
Clés exactes: type, image_url, frame_type
Conditions: Ces clés décrivent chaque objet d’image ; image_url contient uniquement url. Omettez frame_images pour une requête contenant uniquement du texte.
Par défaut—
Champinput_referencesTypearrayExigenceFacultatifValeurs et limitesPar défaut—
ChampsizeTypestringExigenceFacultatifValeurs et limites
1280x720, 720x1280
Motif: ^[1-9][0-9]*x[1-9][0-9]*$
Par défaut—
ChampseedTypeintegerExigenceFacultatifValeurs et limites
Minimum: -9'223'372'036'854'775'808
Maximum: 9'223'372'036'854'775'807
Par défaut—
Champcallback_urlTypestringExigenceFacultatifValeurs et limites
Motif: ^https://
Par défaut—
Champsession_idTypestringExigenceFacultatifValeurs et limitesPar défaut—
ChamptraceTypeobjectExigenceFacultatifValeurs et limitesPar défaut—
ChampuserTypestringExigenceFacultatifValeurs et limitesPar défaut—
Combinaisons d’éléments d’entrée

Texte vers vidéo · Une consigne écrite. · Obligatoire : model, prompt, duration

Fournissez la consigne sous forme de texte et la durée en secondes entières. Choisissez une résolution prise en charge ; ajoutez un rapport largeur/hauteur ou utilisez une taille répertoriée.

model: Type : string · runway/gen-4.5

prompt: Type : string · Nombre maximal d’octets UTF-8: 10'000 · Caractères autres que des espaces requis: Oui

Image vers vidéo · Une consigne écrite et une image de départ. · Obligatoire : model, prompt, duration, frame_images

frame_images est un tableau. Chaque objet d’image comprend type, image_url et frame_type ; image_url contient url. Définissez type sur image_url. Utilisez first_frame. Chaque rôle d’image apparaît au maximum une fois. Fournissez une URL d’image HTTPS publique pour chaque image. Choisissez une résolution prise en charge ; ajoutez un rapport largeur/hauteur ou utilisez une taille répertoriée.

Clés exactes : type, image_url, frame_type

model: Type : string · runway/gen-4.5

prompt: Type : string · Nombre maximal d’octets UTF-8: 10'000 · Caractères autres que des espaces requis: Oui

Paramètres et cycle de vie de la méthode
ParamètreContrat
Paramètrecontent_typeContratapplication/json
ParamètrerequiredContratmodel, prompt, duration
Paramètrematerial_typesContrattext, image
Paramètreadditional_propertiesContratfalse
Paramètreoptional_controlsContratresolution, aspect_ratio, generate_audio, frame_images, input_references, size, seed, callback_url, session_id, trace, user

Cycle de vie : submit_once_poll_original

GET /v1/videos/{public_id}

GET /v1/videos/{public_id}/content

Tarifs

Calcul du coût final

Les tarifs affichés servent à estimer le coût avant la génération. Le montant final est calculé à partir du coût enregistré pour la génération d’origine. La durée mesurée du résultat et les quantités prévisionnelles ne constituent pas la quantité finale facturable.

Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.

Mode rapide
Non précisé Lorsque le mode rapide est sélectionné
Mode Flex
Non précisé Lorsque le mode flex est sélectionné
Effort de raisonnement maximal
Non précisé Lorsque l’effort de raisonnement maximal utilise l’ajustement par défaut (default)

Tarifs estimés à des fins de comparaison

Prix par configuration

Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.

ConfigurationBarème tarifaireQuantité prévisionnelleUnité de facturationConditions de facturationCoût
ConfigurationTarifs de base des jetonsBarème tarifaireTarif de baseQuantité prévisionnelle—Unité de facturation—Conditions de facturation—Coût
Entrée · Tokens en entrée · Estimation à des fins de comparaison uniquement — / 1K tokens
Sortie · Tokens en sortie · Estimation à des fins de comparaison uniquement — / 1K tokens
Entrée · Lecture du cache · Estimation à des fins de comparaison uniquement — / 1K tokens
Entrée · Écriture dans le cache · Estimation à des fins de comparaison uniquement — / 1K tokens
Entrée · Écriture dans le cache, 1 h · Estimation à des fins de comparaison uniquement — / 1K tokens
ConfigurationTarif vidéoBarème tarifaire—Quantité prévisionnelle—Unité de facturationpar seconde de vidéoConditions de facturationCette clé de tarification ne déclare aucune condition supplémentaire.Coût
Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement $0.24 par seconde de vidéo
ConfigurationCoût estimé de la générationBarème tarifaire—Quantité prévisionnelleEstimation pour une générationUnité de facturation—Conditions de facturation—Coût
Sortie · Coût estimé de génération · Estimation à des fins de comparaison uniquement $0.48 estimation avant génération

Cette estimation ne constitue ni des frais supplémentaires ni un tarif fixe pour la génération terminée.

Ailoot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →

Détails du tarif de référence

Les barèmes de référence du modèle ne modifient ni la sélection de méthode, ni les devis, ni les coûts. Les frais actifs utilisent les tarifs de la méthode Ailoot sélectionnée.

Références tarifaires des configurations vidéo

Prix par configuration

ConfigurationConditions de facturationCoût
ConfigurationTarif vidéoConditions de facturationCette clé de tarification ne déclare aucune condition supplémentaire.Coût
Sortie · Tarif vidéo $0.24 par seconde de vidéo

Tarif publié de référence pour la configuration affichée. Les frais définitifs correspondent à la configuration réellement facturée.

Exemples de requêtes

Ailoot Ultra · Vidéo

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"runway/gen-4.5","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n

Recevoir et enregistrer les résultats

Ailoot Ultra · Vidéo

liens de contenu signés dont vous êtes propriétaire

Vérifier l’état de la tâche
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error "$(cat status-url.txt)" \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n
Autres lectures de contenu
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n    urls.append((str(i),u))\nfor label,path in urls:\n    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n    target=Path('owned-'+label+'.bin')\n    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n
Conserver tous les résultats terminés

Enregistrez chaque vidéo terminée ou fichier renvoyé ; récupérez chaque URL de ressource effectivement renvoyée.

Conservez chaque résultat réel dont vous êtes propriétaire et les métadonnées mesurées renvoyées avec celui-ci.

Si la réponse d’origine doit être vérifiée

503 result_pending_check + identifiant d’origine + X-Should-Retry:false ; ne répétez jamais l’envoi d’origine

Champs de la réponse
ChampTypeSignification
ChampindexTypeintegerSignificationPosition de cette vidéo dans la liste des résultats, avec une indexation à partir de zéro.
Champcontent_urlTypestringSignificationURL HTTPS signée de téléchargement de cette vidéo terminée.
Champsha256Typestring | nullSignificationEmpreinte SHA-256 des octets vidéo d’origine ; null si elle est indisponible.
Champsize_bytesTypeinteger | nullSignificationTaille du fichier vidéo d’origine en octets ; null si elle est indisponible.
Champduration_msTypeinteger | nullSignificationDurée mesurée de la vidéo en millisecondes ; null si elle est indisponible.
ChampwidthTypeinteger | nullSignificationLargeur de la vidéo en pixels ; null si elle est indisponible.
ChampheightTypeinteger | nullSignificationHauteur de la vidéo en pixels ; null si elle est indisponible.
Champvideo_codecTypestring | nullSignificationIdentifiant du codec vidéo ; null s’il n’a pas été enregistré.
Champhas_audioTypeboolean | nullSignificationIndique si la vidéo contient une piste audio ; null si cela n’a pas été mesuré.
Champaudio_codecTypestring | nullSignificationIdentifiant du codec audio ; null si aucun identifiant n’a été enregistré.
Erreurs et étapes suivantes
RéponseConditionÉtape suivante
Réponse404 · not_found_errorConditionL’accès à la vidéo est indisponible, ou cet identifiant vidéo est introuvable.Étape suivanteVérifiez l’accès à la vidéo. Pour une vidéo existante, utilisez son identifiant public d’origine et la même clé API.
Réponse401 · authentication_errorConditionLa clé API ne correspond pas au compte authentifié.Étape suivanteVérifiez votre clé API et l’accès au compte avant l’envoi.
Réponse400 · invalid_request_errorConditionLa requête n’a pas pu être lue, ou l’indice de téléchargement est invalide.Étape suivanteCorrigez le corps de la requête. Pour un téléchargement, choisissez un indice de sortie renvoyé par la tâche d’origine.
Réponse422 · price_unavailableConditionLa configuration vidéo sélectionnée ne peut pas être tarifée.Étape suivanteChoisissez une configuration vidéo prise en charge et renseignez toutes ses options obligatoires avant d’envoyer une demande corrigée.
Réponse422 · invalid_request_errorConditionUne entrée vidéo ou une tâche d’origine à prolonger est invalide.Étape suivanteUtilisez des entrées HTTPS valides. Pour une prolongation, utilisez l’identifiant vidéo public de votre vidéo d’origine terminée avec la même clé API.
Réponse402 · billing_errorConditionLe solde disponible ou les limites ne permettent pas de réserver le montant.Étape suivanteVérifiez votre solde disponible et vos limites avant d’envoyer une nouvelle demande.
Réponse503 · server_errorConditionLa vérification vidéo, le stockage ou l’accès au service est temporairement indisponible.Étape suivanteAttendez que le service soit disponible. Si vous avez déjà un identifiant vidéo, vérifiez cette tâche d’origine au lieu de lancer une nouvelle génération.
Réponse503 · result_pending_checkConditionLe résultat vidéo d’origine et sa facturation doivent être vérifiés.Étape suivanteConservez l’identifiant vidéo renvoyé et vérifiez cette tâche. N’envoyez pas de demande de génération de remplacement pendant sa vérification.
Réponse503 · owned_result_unavailableConditionLe téléchargement de la vidéo existante est temporairement indisponible.Étape suivanteVérifiez ultérieurement cette même tâche vidéo et téléchargez son résultat existant. Une nouvelle génération crée une opération distincte.
Réponse409 · video_not_readyConditionLe contenu vidéo n’a pas été publié.Étape suivanteVérifiez l’état de la tâche d’origine. Téléchargez le résultat lorsqu’elle indique completed ; si elle indique failed, suivez son avis de vérification de facturation.

Alias

Alias du modèle

Ailoot Ultra runway/gen-4.5

Alias des chemins de méthode

Utilisez les chemins de méthode indiqués ci-dessus.

ID d’appel associés

runway/gen-4.5

", "method_identity": { "effective_request_model_id": "runway/gen-4.5", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "runway/gen-4.5", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|runway%2Fgen-4.5", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Les tarifs affichés servent à estimer le coût avant la génération. Le montant final est calculé à partir du coût enregistré pour la génération d’origine. La durée mesurée du résultat et les quantités prévisionnelles ne constituent pas la quantité finale facturable.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Conservez chaque résultat réel dont vous êtes propriétaire et les métadonnées mesurées renvoyées avec celui-ci.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "L’accès à la vidéo est indisponible, ou cet identifiant vidéo est introuvable.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Vérifiez l’accès à la vidéo. Pour une vidéo existante, utilisez son identifiant public d’origine et la même clé API.", "type": "not_found_error" }, { "condition": "La clé API ne correspond pas au compte authentifié.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Vérifiez votre clé API et l’accès au compte avant l’envoi.", "type": "authentication_error" }, { "condition": "La requête n’a pas pu être lue, ou l’indice de téléchargement est invalide.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Corrigez le corps de la requête. Pour un téléchargement, choisissez un indice de sortie renvoyé par la tâche d’origine.", "type": "invalid_request_error" }, { "condition": "La configuration vidéo sélectionnée ne peut pas être tarifée.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Choisissez une configuration vidéo prise en charge et renseignez toutes ses options obligatoires avant d’envoyer une demande corrigée.", "type": "price_unavailable" }, { "condition": "Une entrée vidéo ou une tâche d’origine à prolonger est invalide.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Utilisez des entrées HTTPS valides. Pour une prolongation, utilisez l’identifiant vidéo public de votre vidéo d’origine terminée avec la même clé API.", "type": "invalid_request_error" }, { "condition": "Le solde disponible ou les limites ne permettent pas de réserver le montant.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Vérifiez votre solde disponible et vos limites avant d’envoyer une nouvelle demande.", "type": "billing_error" }, { "condition": "La vérification vidéo, le stockage ou l’accès au service est temporairement indisponible.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Attendez que le service soit disponible. Si vous avez déjà un identifiant vidéo, vérifiez cette tâche d’origine au lieu de lancer une nouvelle génération.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Le résultat vidéo d’origine et sa facturation doivent être vérifiés.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Conservez l’identifiant vidéo renvoyé et vérifiez cette tâche. N’envoyez pas de demande de génération de remplacement pendant sa vérification.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Le téléchargement de la vidéo existante est temporairement indisponible.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Vérifiez ultérieurement cette même tâche vidéo et téléchargez son résultat existant. Une nouvelle génération crée une opération distincte.", "type": "server_error" }, { "condition": "Le contenu vidéo n’a pas été publié.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Vérifiez l’état de la tâche d’origine. Téléchargez le résultat lorsqu’elle indique completed ; si elle indique failed, suivez son avis de vérification de facturation.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + identifiant d’origine + X-Should-Retry:false ; ne répétez jamais l’envoi d’origine" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "runway/gen-4.5" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Fournissez la consigne sous forme de texte et la durée en secondes entières. Choisissez une résolution prise en charge ; ajoutez un rapport largeur/hauteur ou utilisez une taille répertoriée.", "required": [ "model", "prompt", "duration" ], "required_material": "Une consigne écrite." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "runway/gen-4.5" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images est un tableau. Chaque objet d’image comprend type, image_url et frame_type ; image_url contient url. Définissez type sur image_url. Utilisez first_frame. Chaque rôle d’image apparaît au maximum une fois. Fournissez une URL d’image HTTPS publique pour chaque image. Choisissez une résolution prise en charge ; ajoutez un rapport largeur/hauteur ou utilisez une taille répertoriée.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Une consigne écrite et une image de départ." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Position de cette vidéo dans la liste des résultats, avec une indexation à partir de zéro.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "URL HTTPS signée de téléchargement de cette vidéo terminée.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "Empreinte SHA-256 des octets vidéo d’origine ; null si elle est indisponible.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Taille du fichier vidéo d’origine en octets ; null si elle est indisponible.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Durée mesurée de la vidéo en millisecondes ; null si elle est indisponible.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Largeur de la vidéo en pixels ; null si elle est indisponible.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Hauteur de la vidéo en pixels ; null si elle est indisponible.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Identifiant du codec vidéo ; null s’il n’a pas été enregistré.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Indique si la vidéo contient une piste audio ; null si cela n’a pas été mesuré.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Identifiant du codec audio ; null si aucun identifiant n’a été enregistré.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "liens de contenu signés dont vous êtes propriétaire", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "runway/gen-4.5" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "runway/gen-4.5" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "720p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "720p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "16:9", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "16:9", "9:16" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Ces clés décrivent chaque objet d’image ; image_url contient uniquement url. Omettez frame_images pour une requête contenant uniquement du texte.", "content": "Tableau d’objets d’image. Chaque objet contient type=image_url, image_url contenant url et frame_type. Utilisez une URL d’image HTTPS et définissez frame_type sur first_frame. Chaque rôle d’image apparaît au maximum une fois.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 1, "max_items": 1, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxItems": 0, "name": "input_references", "required": false, "schema": { "items": false, "maxItems": 0, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "1280x720", "720x1280" ], "enum_known": true, "name": "size", "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "required": false, "schema": { "enum": [ "1280x720", "720x1280" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maximum": 9223372036854775807, "minimum": -9223372036854775808, "name": "seed", "required": false, "schema": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "16:9", "9:16" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": false, "maxItems": 0, "type": "array" }, "model": { "const": "runway/gen-4.5" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "720p" ] }, "seed": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "session_id": { "maxLength": 256, "type": "string" }, "size": { "enum": [ "1280x720", "720x1280" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist." ] }, "unsupported": [ "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "size", "seed", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.24", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output", "label": "Video price", "native_amount_usd_per_unit": "0.24", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "Cette estimation ne constitue ni des frais supplémentaires ni un tarif fixe pour la génération terminée.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Coût estimé de la génération", "units": [ { "amount": "0.48", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.48", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":8,\"model\":\"runway/gen-4.5\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"720p\"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n target=Path('owned-'+label+'.bin')\n subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.24", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output", "label": "Video price", "native_amount_usd_per_unit": "0.24", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.48", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.48", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "runway/gen-4.5", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.24", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output", "label": "Video price", "native_amount_usd_per_unit": "0.24", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.48", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.48", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } } ], "model_id": "runway/gen-4.5", "nativeProvenance": { "input_facts_canonical_sha256": "48111b1c1c1d57d1a327aedd04c7140ce40b76f9286dd981c84df7efea5f0277", "input_html_sha256": "32606d6c241f5d99b0b705eb6b41277cb5b3d402a2b64edb6d3a308b25c36a69", "private_audit_sha256": "b704d4248557120bfc15c8fd718eb5189f5905383398fe76a477d04f358d391d", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/fr-ch/runway-gen-4-5/", "description": "Runway Gen-4.5 crée des vidéos à partir d’une description de scène ou d’une image accompagnée de consignes de mouvement. Ses clips de 2 à 10 secondes, les instructions explicites de caméra et les choix de composition distincts selon l’entrée texte ou image conviennent aux concepts cinématographiques, aux plans d’illustration et aux scènes visuelles animées.", "locale": "fr-ch", "md_url": "https://ailoot.ai/models/fr-ch/runway-gen-4-5/index.md", "title": "Runway: Gen-4.5 — Ailoot", "url": "https://ailoot.ai/models/fr-ch/runway-gen-4-5/" }, "rawModel": { "about": "Runway Gen-4.5 est un modèle de génération vidéo doté de modes à partir de texte ou d’une image. Il peut suivre un brief décrivant la composition d’une scène, l’action du sujet, la chorégraphie de la caméra et une suite d’événements. Le résultat utile est un court plan généré qui peut être examiné, conservé ou assemblé avec d’autres images filmées.\n\n### Choisir le mode d’entrée du plan\n\nLa génération de vidéo à partir de texte commence par une description écrite de la scène. Précisez à la fois le contenu visible et le mouvement : sujet, décor, éclairage, cadrage, action et comportement de la caméra. Ce mode convient à une nouvelle scène, à un plan d’illustration, à un plan de fond ou à un concept visuel dont l’image initiale n’a pas à reproduire une image fournie.\n\nLa génération de vidéo à partir d’une image commence par une image qui sert de première image du clip. Elle fournit la composition, le contenu, l’éclairage et le style. Concentrez le prompt écrit sur la suite : action du sujet, mouvements dans l’environnement, mouvement de caméra et progression du plan.\n\nPréparez une image nette où les détails importants sont déjà visibles. Les visages flous, les mains floues ou d’autres artefacts peuvent devenir plus visibles une fois animés. Une référence qui suggère un mouvement rapide par de la poussière ou du flou de mouvement peut aussi contredire un prompt demandant un sujet immobile.\n\n### Décrire directement les visuels et le mouvement\n\nUtilisez un langage naturel clair et des descriptions positives du résultat souhaité. Un brief à partir de texte peut commencer par le point de vue de la caméra, le sujet et l’action, puis préciser le traitement de la scène. Une description détaillée est utile lorsque le plan répond à des exigences définies ; une description plus simple laisse davantage de place à l’exploration. Aucun nombre de mots idéal ne remplace la clarté.\n\nPar exemple, décrivez une vue rapprochée d’une lampe de bureau en laiton qui s’allume, suivie d’un lent mouvement de caméra révélant un carnet à côté. Pour la génération à partir de texte, précisez les matériaux visibles et la lumière. Si une image fournie définit déjà ces détails, le prompt de génération à partir d’image peut se concentrer sur le changement de lumière et la révélation par la caméra.\n\nÉvitez les consignes contradictoires. Une vue fixe avec de légers mouvements du sujet diffère d’un travelling énergique à caméra portée. Ajoutez les détails qui définissent le plan utile plutôt qu’une longue liste de styles visuels sans rapport entre eux.\n\n### Vocabulaire de caméra et actions en séquence\n\nLe guide de caméra du producteur distingue le cadrage, les angles, le mouvement et la mise au point. Un gros plan change ce qui remplit l’image, une contre-plongée change la perspective, un panoramique fait pivoter la vue de la caméra et un travelling d’accompagnement suit un sujet. Une consigne de bascule de point déplace la mise au point entre des sujets visibles. Précisez ce qui doit rester visible ou être révélé pendant le mouvement.\n\nLes prompts séquentiels peuvent exprimer les événements en langage courant ou avec des repères temporels approximatifs. Ces repères guident l’ordre et les temps approximatifs ; ils ne garantissent pas une exécution à l’image près. Laissez aux actions demandées le temps de se dérouler naturellement dans la durée de clip choisie.\n\nPour un plan fixe, décrivez le mouvement qui doit se produire à l’intérieur de l’image et renforcez l’intention d’une caméra immobile. Le producteur indique que les vues totalement immobiles peuvent être difficiles, surtout pour certains plans larges ou d’ensemble. Examinez les petits mouvements indésirables dans le résultat réel au lieu de supposer qu’une formule demandant une caméra fixe les rend impossibles.\n\n### Durée, dimensions et fréquence d’images\n\nGen-4.5 prend en charge des clips de 2 à 10 secondes. Une durée plus longue peut accueillir plusieurs actions ordonnées, tandis qu’une brève réaction ou révélation peut utiliser un plan plus court. La sortie documentée est en 720p, à 24 ou 25 images par seconde dans le processus de génération du producteur.\n\nLa spécification de génération à partir de texte indique le 16:9 en 1280 × 720 pixels. La génération à partir d’image ajoute le 9:16 en 720 × 1280, le 1:1 en 960 × 960, le 4:3 en 1104 × 832, le 3:4 en 832 × 1104 et le 21:9 en 1584 × 672. Associez toujours le mode à ses dimensions réelles, au lieu de supposer que les deux modes d’entrée proposent les mêmes rapports largeur/hauteur.\n\nLe rapport de l’image peut définir la composition par défaut, et sa modification peut recadrer l’entrée. Vérifiez l’emplacement du sujet avant de juger le mouvement : une action correcte n’est pas utile si une partie essentielle de l’image source a été coupée.\n\n### Construire une séquence plus longue à partir de plans terminés\n\nPour les travaux guidés par une image, le producteur décrit le prolongement d’une séquence en utilisant la dernière image d’un clip terminé comme image d’entrée d’une autre génération. Les clips sont ensuite combinés dans un logiciel de montage, où sont traités leur image commune et leurs temps. Il s’agit d’une suite de plans distincts, et non d’une génération unique de durée illimitée.\n\nConservez l’image finale et le brief correspondant afin que le plan suivant commence dans l’état visuel prévu. Vérifiez la continuité dans les séquences assemblées, notamment l’apparence du sujet, la direction de la caméra et la transition entre les clips.\n\n### Conserver et examiner le livrable de production\n\nAprès la génération, examinez le clip entier et conservez la sortie terminée. Le processus du producteur propose aussi des choix distincts d’agrandissement et d’export de production, tels que ProRes ou une séquence PNG. Ce sont des options supplémentaires du processus ; les dimensions natives de génération restent distinctes d’un résultat agrandi ultérieurement.\n\nUtilisez Gen-4.5 pour des concepts cinématographiques, des idées visuelles animées, des plans d’illustration et le développement de courtes scènes. Conservez ensemble le prompt, l’image d’entrée lorsqu’elle est utilisée, la durée, le mode et le clip renvoyé. Vérifiez l’ordre des actions, le comportement de la caméra, les détails du sujet, les coupes indésirables et le cadrage souhaité, puis apportez une correction ciblée au plan.", "alias_of": null, "aliases": [], "author": "Runway", "available": null, "canonical_model": "runway/gen-4.5", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.48", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.48", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "La tarification complète de la configuration figure dans les détails." } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "cb4a8a486aaac9d58ece6322", "label": "Références tarifaires des configurations vidéo", "profiles": [ { "basis": "Tarif publié de référence pour la configuration affichée. Les frais définitifs correspondent à la configuration réellement facturée.", "dimensions": { "conditions": "Cette clé de tarification ne déclare aucune condition supplémentaire." }, "label": "Tarif vidéo", "units": [ { "amount": "0.24", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] } ] } ], "entity_type": "model", "formats": [ "videos" ], "id": "runway/gen-4.5", "input": [ "text", "image" ], "kind": "video", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Les tarifs affichés servent à estimer le coût avant la génération. Le montant final est calculé à partir du coût enregistré pour la génération d’origine. La durée mesurée du résultat et les quantités prévisionnelles ne constituent pas la quantité finale facturable.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Conservez chaque résultat réel dont vous êtes propriétaire et les métadonnées mesurées renvoyées avec celui-ci.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "L’accès à la vidéo est indisponible, ou cet identifiant vidéo est introuvable.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Vérifiez l’accès à la vidéo. Pour une vidéo existante, utilisez son identifiant public d’origine et la même clé API.", "type": "not_found_error" }, { "condition": "La clé API ne correspond pas au compte authentifié.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Vérifiez votre clé API et l’accès au compte avant l’envoi.", "type": "authentication_error" }, { "condition": "La requête n’a pas pu être lue, ou l’indice de téléchargement est invalide.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Corrigez le corps de la requête. Pour un téléchargement, choisissez un indice de sortie renvoyé par la tâche d’origine.", "type": "invalid_request_error" }, { "condition": "La configuration vidéo sélectionnée ne peut pas être tarifée.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Choisissez une configuration vidéo prise en charge et renseignez toutes ses options obligatoires avant d’envoyer une demande corrigée.", "type": "price_unavailable" }, { "condition": "Une entrée vidéo ou une tâche d’origine à prolonger est invalide.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Utilisez des entrées HTTPS valides. Pour une prolongation, utilisez l’identifiant vidéo public de votre vidéo d’origine terminée avec la même clé API.", "type": "invalid_request_error" }, { "condition": "Le solde disponible ou les limites ne permettent pas de réserver le montant.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Vérifiez votre solde disponible et vos limites avant d’envoyer une nouvelle demande.", "type": "billing_error" }, { "condition": "La vérification vidéo, le stockage ou l’accès au service est temporairement indisponible.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Attendez que le service soit disponible. Si vous avez déjà un identifiant vidéo, vérifiez cette tâche d’origine au lieu de lancer une nouvelle génération.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Le résultat vidéo d’origine et sa facturation doivent être vérifiés.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Conservez l’identifiant vidéo renvoyé et vérifiez cette tâche. N’envoyez pas de demande de génération de remplacement pendant sa vérification.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Le téléchargement de la vidéo existante est temporairement indisponible.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Vérifiez ultérieurement cette même tâche vidéo et téléchargez son résultat existant. Une nouvelle génération crée une opération distincte.", "type": "server_error" }, { "condition": "Le contenu vidéo n’a pas été publié.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Vérifiez l’état de la tâche d’origine. Téléchargez le résultat lorsqu’elle indique completed ; si elle indique failed, suivez son avis de vérification de facturation.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + identifiant d’origine + X-Should-Retry:false ; ne répétez jamais l’envoi d’origine" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "runway/gen-4.5" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Fournissez la consigne sous forme de texte et la durée en secondes entières. Choisissez une résolution prise en charge ; ajoutez un rapport largeur/hauteur ou utilisez une taille répertoriée.", "required": [ "model", "prompt", "duration" ], "required_material": "Une consigne écrite." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "runway/gen-4.5" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images est un tableau. Chaque objet d’image comprend type, image_url et frame_type ; image_url contient url. Définissez type sur image_url. Utilisez first_frame. Chaque rôle d’image apparaît au maximum une fois. Fournissez une URL d’image HTTPS publique pour chaque image. Choisissez une résolution prise en charge ; ajoutez un rapport largeur/hauteur ou utilisez une taille répertoriée.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Une consigne écrite et une image de départ." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Position de cette vidéo dans la liste des résultats, avec une indexation à partir de zéro.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "URL HTTPS signée de téléchargement de cette vidéo terminée.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "Empreinte SHA-256 des octets vidéo d’origine ; null si elle est indisponible.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Taille du fichier vidéo d’origine en octets ; null si elle est indisponible.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Durée mesurée de la vidéo en millisecondes ; null si elle est indisponible.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Largeur de la vidéo en pixels ; null si elle est indisponible.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Hauteur de la vidéo en pixels ; null si elle est indisponible.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Identifiant du codec vidéo ; null s’il n’a pas été enregistré.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Indique si la vidéo contient une piste audio ; null si cela n’a pas été mesuré.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Identifiant du codec audio ; null si aucun identifiant n’a été enregistré.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "liens de contenu signés dont vous êtes propriétaire", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "runway/gen-4.5" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "runway/gen-4.5" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "720p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "720p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "16:9", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "16:9", "9:16" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Ces clés décrivent chaque objet d’image ; image_url contient uniquement url. Omettez frame_images pour une requête contenant uniquement du texte.", "content": "Tableau d’objets d’image. Chaque objet contient type=image_url, image_url contenant url et frame_type. Utilisez une URL d’image HTTPS et définissez frame_type sur first_frame. Chaque rôle d’image apparaît au maximum une fois.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 1, "max_items": 1, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxItems": 0, "name": "input_references", "required": false, "schema": { "items": false, "maxItems": 0, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "1280x720", "720x1280" ], "enum_known": true, "name": "size", "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "required": false, "schema": { "enum": [ "1280x720", "720x1280" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maximum": 9223372036854775807, "minimum": -9223372036854775808, "name": "seed", "required": false, "schema": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "16:9", "9:16" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": false, "maxItems": 0, "type": "array" }, "model": { "const": "runway/gen-4.5" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "720p" ] }, "seed": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "session_id": { "maxLength": 256, "type": "string" }, "size": { "enum": [ "1280x720", "720x1280" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist." ] }, "unsupported": [ "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "size", "seed", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.24", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output", "label": "Video price", "native_amount_usd_per_unit": "0.24", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "Cette estimation ne constitue ni des frais supplémentaires ni un tarif fixe pour la génération terminée.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Coût estimé de la génération", "units": [ { "amount": "0.48", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.48", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":8,\"model\":\"runway/gen-4.5\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"720p\"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n target=Path('owned-'+label+'.bin')\n subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.24", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output", "label": "Video price", "native_amount_usd_per_unit": "0.24", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.48", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.48", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "runway/gen-4.5", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.24", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output", "label": "Video price", "native_amount_usd_per_unit": "0.24", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.48", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.48", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "runway/gen-4.5", "request_model_id": "runway/gen-4.5", "route_label": "Ultra" } ], "name": "Runway: Gen-4.5", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 0.48, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 0.48, "varies": false }, "pricing_profiles": [ { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "credit_usd": "0.01", "credits_per_second": "12" }, "label": "Ultra", "units": [ { "amount": "0.24", "amount_unit": "usd_per_output_video_second", "conditions": { "credit_usd": "0.01", "credits_per_second": "12" }, "key": "base", "label": "base", "profile_index": 0, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "format_class": "prores_or_png_sequence", "surcharge_adds_to_model_base": true }, "label": "Ultra", "units": [ { "amount": "0.10", "amount_unit": "usd_per_output_video_second", "conditions": { "format_class": "prores_or_png_sequence", "surcharge_adds_to_model_base": true }, "key": "base", "label": "base", "profile_index": 1, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "format_class": "10bit_or_hdr_up_to_4mp", "surcharge_adds_to_model_base": true }, "label": "Ultra", "units": [ { "amount": "0.40", "amount_unit": "usd_per_output_video_second", "conditions": { "format_class": "10bit_or_hdr_up_to_4mp", "surcharge_adds_to_model_base": true }, "key": "base", "label": "base", "profile_index": 2, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "format_class": "10bit_or_hdr_above_4mp", "surcharge_adds_to_model_base": true }, "label": "Ultra", "units": [ { "amount": "0.80", "amount_unit": "usd_per_output_video_second", "conditions": { "format_class": "10bit_or_hdr_above_4mp", "surcharge_adds_to_model_base": true }, "key": "base", "label": "base", "profile_index": 3, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "no_method_admission_claim": true, "scope": "supplier_tariff_reference" }, "dimensions": {}, "label": "Ailoot Ultra · Tariff components", "units": [ { "amount": "0.24", "amount_unit": "usd_per_exact_physical_unit", "basis": "output second", "billing_original_currency": "USD_cent", "billing_original_rate": "24", "key": "cents_per_second_output", "label": "output second", "native_amount_usd_per_unit": "0.24", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" } ] } ], "public_id": "runway/gen-4.5", "short": "Runway Gen-4.5 crée des vidéos à partir d’une description de scène ou d’une image accompagnée de consignes de mouvement. Ses clips de 2 à 10 secondes, les instructions explicites de caméra et les choix de composition distincts selon l’entrée texte ou image conviennent aux concepts cinématographiques, aux plans d’illustration et aux scènes visuelles animées." }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "Runway Gen-4.5 crée des vidéos à partir d’une description de scène ou d’une image accompagnée de consignes de mouvement. Ses clips de 2 à 10 secondes, les instructions explicites de caméra et les choix de composition distincts selon l’entrée texte ou image conviennent aux concepts cinématographiques, aux plans d’illustration et aux scènes visuelles animées.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_exact_canonical_sha256": "6790addecfe96f59ea1db47c7cffcccb37aec87ccdcdf5abd6d82392956b0220", "raw_model_js_projection_sha256": "717e72f326eca3944f2789a02939235569355fcfc2b428c65b85cb58b408749c", "raw_model_json_sha256": "6790addecfe96f59ea1db47c7cffcccb37aec87ccdcdf5abd6d82392956b0220", "renderer_sha256": "4d2f3bfcbf0fa5c616c87aa9524d00d7cff227d8dfa2446ff47c8e0220325dc9" }, "sourceRevision": "588bed1fccef9a1d0ce158f162557e835e846ac1ea20e57881ffd8c6f6b80aa3" }