Configuration de l'API Vidéo Runway
Runway est une plateforme de génération vidéo. Il ne s'agit généralement pas d'une Base URL à renseigner dans Chatbox. Vous devez plutôt créer une clé API sur la plateforme Runway, puis utiliser le SDK officiel ou des requêtes HTTP pour créer des tâches vidéo.
Informations officielles Les téléchargements et la documentation font foi sur le site officiel.
Pour quels scénarios est-ce adapté
Text-to-VideoImage-to-VideoAsynchronous TasksOfficial SDK
Comprendre d'abord le flux de travail des tâches vidéo
- Créez une clé API et assurez-vous que votre compte dispose des autorisations nécessaires pour l'API vidéo ainsi que d'un solde suffisant.
- Sélectionnez le type de tâche : texte-vers-vidéo, image-vers-vidéo ou d'autres tâches vidéo actuellement prises en charge par la documentation officielle.
- Vous n'obtiendrez pas le fichier vidéo immédiatement après avoir soumis une tâche ; généralement, vous recevrez d'abord un objet tâche ou un identifiant de tâche.
- Attendez la fin de la tâche, puis lisez l'adresse de sortie ou téléchargez les résultats.
- En cas d'échec, vérifiez d'abord l'état de la tâche et les détails de l'erreur, ne vous contentez pas de vérifier la clé.
Préparer les paramètres
| Élément de configuration | Méthode de saisie |
|---|---|
| API Key | Création dans l'espace Runway ; le SDK officiel lit <code>RUNWAYML_API_SECRET</code> par défaut |
| Task | texte-vers-vidéo / image-vers-vidéo |
| Prompt | Description du contenu vidéo |
| Ratio / Size | Paysage, portrait ou dimensions spécifiées |
| Duration | Durée de la vidéo |
| Status | Interroger la tâche (polling) jusqu'à son achèvement |
| Paramètre | Description | Conseils pour débutants |
|---|---|---|
| API Key | Identifiants de requête pour l'API Runway | Enregistrez-les uniquement dans les variables d'environnement de la machine locale ou du serveur, sous le nom RUNWAYML_API_SECRET |
| Prompt | Description du contenu vidéo | Rédigez d'abord un texte court, puis affinez après avoir validé le style |
| Image | L'image de départ pour l'image-vers-vidéo | Téléversez des images nettes avec un sujet bien défini |
| Duration | Secondes de la vidéo | Testez d'abord le coût et le rendu avec une durée plus courte |
| Status | État de la tâche | La génération vidéo est asynchrone et nécessite d'attendre la finalisation. |
Exemple de SDK
Nom de la variable d'environnement Runway
RUNWAYML_API_SECRET=YOUR_RUNWAY_API_KEYExemple de tâche Runway Node.js
import RunwayML, { TaskFailedError } from "@runwayml/sdk"; const client = new RunwayML(); try { const task = await client.imageToVideo.create({ model: "gen4.5", promptText: "A product introduction video on a white background with a slow camera push-in", ratio: "1280:720", duration: 5 }).waitForTaskOutput(); console.log(task.output[0]); } catch (error) { if (error instanceof TaskFailedError) { console.error(error.taskDetails); } }Les champs de la plateforme vidéo évoluent avec les versions de modèles. Cet exemple de page sert à comprendre la structure de configuration ; pour les champs réels, veuillez vous référer à la version actuelle de la documentation officielle.
| Phénomène | Vérification prioritaire | Résolution |
|---|---|---|
| La vidéo n'est pas renvoyée immédiatement après la soumission | La tâche est-elle toujours dans la file d'attente ou en cours de génération ? | La génération vidéo est une tâche asynchrone ; attendez que l'état soit terminé avant de récupérer le résultat. |
| Échec de la tâche | Nom du modèle, ratio, durée, conformité de l'image d'entrée avec les exigences du modèle actuel | Ajustez les paramètres en fonction des détails d'erreur renvoyés, sans modifier trop d'éléments à la fois. |
| Les frais sont plus élevés que prévu | Durée, résolution, version du modèle | Testez d'abord avec une durée courte et des paramètres à faible coût avant de générer en masse |