Configuration complète de l'API Runway

PRÉREQUIS : Exécutez d'abord +rw-check-compatibility pour vérifier que le projet dispose d'une capacité côté serveur.

Cette recette guide l'utilisateur à travers le processus complet d'intégration de l'API publique de Runway dans son projet. Elle enchaîne la vérification de compatibilité, la configuration de la clé API et les compétences d'intégration API.

Workflow

Phase 1 : Vérification de compatibilité

Utilisez +rw-check-compatibility pour analyser le projet de l'utilisateur.

Identifier le type de projet (Node.js, Python, etc.)
Vérifier la capacité côté serveur
Vérifier la compatibilité des versions runtime
Rechercher une installation existante du SDK Runway

Si le projet est INCOMPATIBLE, arrêtez et expliquez les options :

Ajouter un backend (Express, FastAPI, etc.)
Utiliser un framework fullstack (Next.js, SvelteKit, Nuxt, Remix)
Ajouter des fonctions serverless (Vercel Functions, AWS Lambda)
Créer un service backend distinct

Si NÉCESSITE DES CHANGEMENTS, aidez l'utilisateur à effectuer les modifications requises avant de continuer.

Si COMPATIBLE, passez à la Phase 2.

Phase 2 : Configuration de la clé API

Utilisez +rw-setup-api-key pour configurer les identifiants.

Dirigez l'utilisateur vers https://dev.runwayml.com/ pour créer un compte et une clé API
Installez le SDK approprié (@runwayml/sdk pour Node.js, runwayml pour Python)
Configurez la variable d'environnement RUNWAYML_API_SECRET
Mettez à jour .gitignore pour exclure .env
Rappelez l'exigence d'achat de crédits (minimum 10 $)

Attendez la confirmation de l'utilisateur qu'il dispose de sa clé API avant de continuer.

Phase 3 : Déterminer ce qu'il faut intégrer

Demandez à l'utilisateur ce qu'il souhaite construire. En fonction de sa réponse, utilisez la compétence d'intégration appropriée :

L'utilisateur souhaite...	Compétence à utiliser
Générer des vidéos à partir de texte	`+rw-integrate-video` (text-to-video)
Animer des images en vidéo	`+rw-integrate-video` (image-to-video) + `+rw-integrate-uploads` si fichiers locaux
Éditer/transformer des vidéos existantes	`+rw-integrate-video` (video-to-video) + `+rw-integrate-uploads`
Générer des images à partir de texte	`+rw-integrate-image`
Générer des images avec références	`+rw-integrate-image` + `+rw-integrate-uploads` si références locales
Synthèse vocale	`+rw-integrate-audio`
Effets sonores	`+rw-integrate-audio`
Isolation vocale/doublage	`+rw-integrate-audio` + `+rw-integrate-uploads`
Avatar conversationnel temps réel	`+rw-integrate-characters` + `+rw-integrate-character-embed` (UI React)
Avatar avec connaissance métier	`+rw-integrate-characters` + `+rw-integrate-documents` + `+rw-integrate-character-embed`
Plusieurs fonctionnalités	Intégrez chacune en partageant la même instance client

Phase 4 : Écrire le code d'intégration

En fonction du framework et des besoins de l'utilisateur :

Créer la route/le gestionnaire API — endpoint côté serveur qui appelle Runway
Ajouter la gestion des uploads si l'utilisateur doit accepter des fichiers de ses utilisateurs
Ajouter la gestion des erreurs — capturer et gérer les échecs de tâches
Gérer le stockage des résultats — rappeler à l'utilisateur que les URL de résultats expirent en 24-48 heures

Phase 5 : Tester et vérifier

Aidez l'utilisateur à :

Exécuter une génération de test pour vérifier que tout fonctionne
Vérifier les problèmes courants (variable d'environnement manquante, crédits insuffisants, modèle incorrect)
Confirmer que la sortie est accessible

Arbre de décision pour les exigences d'upload

Quand le workflow de l'utilisateur implique des images ou des vidéos en entrée :

L'entrée provient-elle d'une URL HTTPS publique ?
├── OUI → Passez l'URL directement à l'API
└── NON → Est-ce un fichier local ou un fichier uploadé par l'utilisateur ?
    ├── OUI → Utilisez +rw-integrate-uploads pour uploader d'abord, puis passez l'URI runway://
    └── NON → Est-ce suffisamment petit pour un data URI ? (< 5 MB image, < 16 MB vidéo)
        ├── OUI → Convertissez en data URI base64
        └── NON → Utilisez +rw-integrate-uploads

Rappels importants

N'exposez jamais la clé API dans le code côté client. Tous les appels API doivent se faire côté serveur.
Les URL de résultats expirent. Téléchargez toujours et stockez le contenu généré.
Les crédits sont obligatoires. L'API ne fonctionnera pas sans crédits prépayés.
Les limites de débit existent. Vous devez toujours vérifier quelle est la limite de débit avant d'essayer des générations concurrentes.
La modération de contenu s'applique aux entrées et aux résultats. Les entrées signalées comme non sûres ne sont pas remboursables.
Soyez conscient des coûts. Aidez les utilisateurs à choisir le bon modèle selon leur budget. Le coût en crédits peut être trouvé sur https://docs.dev.runwayml.com/guides/pricing/

rw-recipe-full-setup