runway_video

Spécifications techniques de runway-video

Qu’est-ce que runway-video ?

runway-video est l’identifiant de plateforme de CometAPI pour accéder aux capacités de génération vidéo de Runway via une API unifiée. D’après la documentation officielle de l’API Runway, Runway propose plusieurs modèles vidéo pour générer des clips à partir d’invites textuelles ou d’images, avec des endpoints basés sur des tâches pour lancer les générations puis récupérer les résultats ultérieurement.

En pratique, runway-video s’entend mieux comme une porte d’entrée vers des flux de création vidéo propulsés par Runway plutôt que comme le nom d’un modèle de base autonome unique. Le catalogue actuel de l’API Runway inclut plusieurs modèles vidéo avec différents modes d’entrée et paliers de tarification, tels que gen4.5 pour le texte‑ou‑l’image‑vers‑vidéo, gen4_turbo pour l’image‑vers‑vidéo, ainsi que d’autres options comme gen4_aleph, veo3, veo3.1, veo3.1_fast et gen3a_turbo.

Cela rend runway-video adapté à des applications telles que le prototypage créatif, la génération de contenus marketing, la production de clips pour les réseaux sociaux, la visualisation de concepts et les expériences produit nécessitant une synthèse automatisée de vidéos courtes. Comme l’API Runway sous-jacente utilise des tâches asynchrones, les intégrations soumettent généralement d’abord une requête de génération, puis interrogent ou récupèrent la sortie de la tâche une fois le traitement terminé.

Principales fonctionnalités de runway-video

• Génération texte‑vers‑vidéo : Runway prend en charge la création de vidéos à partir d’invites en langage naturel sur les modèles compatibles, permettant de générer des clips directement à partir de descriptions textuelles.
• Flux image‑vers‑vidéo : Plusieurs modèles vidéo Runway acceptent des entrées image, ce qui rend runway-video utile pour animer des images fixes ou construire des pipelines de génération vidéo guidés par des références.
• Multiples options de modèles sous-jacents : L’API Runway expose plusieurs modèles vidéo avec des capacités et des profils de coût variés, offrant la flexibilité d’optimiser pour la qualité, la vitesse ou le budget.
• Traitement asynchrone des tâches : Les requêtes de génération créent des tâches au lieu de renvoyer immédiatement le média final, ce qui convient aux systèmes de production nécessitant mise en file d’attente, relances et vérifications d’état.
• Téléversements temporaires de ressources : Runway propose des endpoints de téléversement qui renvoient des références runwayUri, facilitant l’injection d’images, de vidéos ou d’audios dans les requêtes de génération ultérieures.
• Prise en charge officielle des SDK : Runway fournit des SDK Node.js et Python, simplifiant l’authentification, la construction des requêtes et la récupération des résultats.
• Intégration d’API versionnée : Les requêtes exigent un en-tête explicite X-Runway-Version, ce qui aide les développeurs à s’intégrer contre un contrat d’API connu.
• Tarification basée sur des crédits : Runway facture la génération vidéo en crédits par seconde, avec un prix variable selon le modèle sous-jacent sélectionné.

Comment accéder à runway-video et l’intégrer

Étape 1 : S’inscrire et obtenir une clé d’API

Pour accéder à runway-video, commencez par créer un compte et générer une clé d’API via votre tableau de bord CometAPI. Après connexion, copiez votre clé d’API et stockez-la en toute sécurité dans une variable d’environnement ou un gestionnaire de secrets pour un usage en production.

Étape 2 : Envoyer des requêtes à l’API runway-video

Utilisez votre clé d’API pour authentifier les requêtes vers l’endpoint CometAPI pour runway-video. Transmettez votre invite et tout paramètre d’entrée pris en charge dans le corps de la requête, et spécifiez le modèle comme runway-video.

curl -X POST "https://api.cometapi.com/v1/responses" \
  -H "Authorization: Bearer $COMETAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "runway-video",
    "input": "Create a cinematic video of a futuristic city at sunrise with slow camera movement."
  }'

Étape 3 : Récupérer et vérifier les résultats

Après la soumission, examinez la réponse de l’API pour y trouver la sortie générée, l’identifiant de tâche ou la charge utile de résultat renvoyée pour runway-video. Si la génération s’exécute de manière asynchrone, interrogez l’endpoint CometAPI pertinent jusqu’à la fin du traitement, puis validez l’URL de la vidéo renvoyée, les métadonnées et le contenu avant de l’utiliser dans votre application.