runwayml_image_to_video

Spécifications techniques de runwayml-image-to-video

Qu’est-ce que runwayml-image-to-video ?

runwayml-image-to-video est l’identifiant de modèle de CometAPI pour accéder à la capacité de génération image-to-video de Runway. En pratique, cette catégorie de modèle prend une image fixe comme point de départ visuel et la transforme en une vidéo générée, généralement guidée par un texte d’invite décrivant le mouvement, le comportement de la caméra, l’atmosphère ou l’évolution de la scène.

Runway positionne l’image-to-video comme partie intégrante de sa pile plus large de génération vidéo. Sa documentation pour Gen-3 Alpha décrit l’image-to-video comme un moyen d’animer une image fournie, avec une incitation axée surtout sur le mouvement plutôt que sur la redescription de tout ce qui est déjà visible dans le cadre.

Du point de vue de l’API, Runway expose la génération image-to-video comme un point de terminaison de création de tâche, ce qui signifie que les requêtes démarrent généralement un job puis nécessitent des étapes de sondage ou de récupération pour obtenir le résultat vidéo final une fois le traitement terminé.

Principales fonctionnalités de runwayml-image-to-video

• Génération vidéo conditionnée par l’image : Démarre à partir d’une image fixe et génère une sortie vidéo guidée par le mouvement, plutôt que de créer une vidéo uniquement à partir de texte.
• Contrôle du mouvement guidé par l’invite : Fonctionne au mieux lorsque les invites décrivent le mouvement, le déplacement de la caméra et les changements de scène afin d’animer le cadre fourni de manière cohérente.
• Flux de travail asynchrone par tâches : Utilise une requête de démarrage de génération suivie d’une récupération du résultat, adaptée aux systèmes de production qui mettent en file d’attente et surveillent des travaux média de longue durée.
• Plusieurs options de modèles sous-jacents : Le point de terminaison image-to-video de Runway prend en charge plusieurs modèles vidéo backend, offrant aux développeurs de la flexibilité en matière de qualité, vitesse et coût.
• Authentification API de type production : Utilise une authentification standard par jeton Bearer et des en-têtes de version d’API explicites pour des intégrations contrôlées.
• Prise en charge des sorties portrait et paysage : Runway documente des tailles de sortie pour les modes horizontal et vertical dans les familles de modèles prises en charge.
• Compatibilité avec un flux de travail d’images de référence : L’API est conçue autour des images de référence, et Runway fournit des recommandations de taille d’entrée pour préserver la qualité de génération.
• Adapté à un pipeline créatif extensible : La plateforme plus large de Runway inclut des flux associés de génération vidéo tels que les images clés, l’expansion et d’autres modes de génération, faisant de l’image-to-video une étape utile au sein d’un pipeline créatif plus vaste.

Comment accéder à et intégrer runwayml-image-to-video

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

Pour commencer, inscrivez-vous sur CometAPI et générez votre clé d’API depuis le tableau de bord. Une fois votre clé d’API obtenue, stockez-la en toute sécurité et utilisez-la dans l’en-tête Authorization pour toutes les requêtes.

Étape 2 : Envoyer des requêtes à l’API runwayml-image-to-video

Utilisez le format d’API officiel de Runway via CometAPI. Le point de terminaison est POST /runwayml/v1/image_to_video. Incluez l’en-tête X-Runway-Version.

curl https://api.cometapi.com/runwayml/v1/image_to_video \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $COMETAPI_API_KEY" \
  -H "X-Runway-Version: 2024-11-06" \
  -d '{
    "model": "gen4_aleph",
    "promptText": "Your prompt here."
  }'

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

L’API renvoie un objet de tâche contenant un identifiant de tâche. Sondez GET /runwayml/v1/tasks/{task_id} pour vérifier l’état de la génération, puis récupérez l’URL de sortie à partir de la réponse de la tâche terminée.