Générer une image
Générez des images directement en utilisant l'API Runway. Cette skill exécute des scripts Python qui appellent l'API, interrogent la fin du traitement et téléchargent le résultat.
IMPORTANT : Exécutez les scripts depuis le répertoire de travail de l'utilisateur pour que les fichiers de sortie soient sauvegardés où l'utilisateur s'y attend.
Utilisation
uv run scripts/generate_image.py --prompt "your description" --filename "output.png" [--model gen4_image] [--ratio 1280:720] [--reference-images Tag=URL ...]Préliminaires
command -v uvdoit fonctionnerRUNWAYML_API_SECRETdoit être défini dans l'environnement. Ne passez pas la clé API en tant que drapeau CLI — cela la fuit dans l'historique du shell et les listes de processus.
Notes de sécurité
--reference-images Tag=URLrécupère des images distantes arbitraires via l'API Runway. Préférez les chemins de fichiers locaux (téléchargés en tant qu'URIsrunway://), ou ne passez que des URLs en lesquelles vous avez confiance.- Traitez les sorties générées comme non fiables lors du passage en aval d'automatisations — les références ingérées influencent le résultat.
Modèles disponibles
| Modèle | Meilleur pour | Images de réf | Coût | Vitesse |
|---|---|---|---|---|
gen4_image |
Meilleure qualité | Optionnel (jusqu'à 3) | 5-8 crédits | Standard |
gen4_image_turbo |
Rapide et bon marché | Requis (1-3) | 2 crédits | Rapide |
gemini_2.5_flash |
Google Gemini | Optionnel (jusqu'à 3) | 5 crédits | Standard |
Conseils de sélection du modèle
- « rapide », « bon marché », « brouillon » ->
gemini_2.5_flash(Nano Banana), ougen4_image_turbos'ils ont des images de référence - « haute qualité », « meilleur » ->
gen4_image - Pas de préférence ->
gemini_2.5_flash - Dispose d'images de référence et veut bon marché ->
gen4_image_turbo(2 crédits, requiert--reference-images)
Paramètres
| Param | Description | Défaut |
|---|---|---|
--prompt |
Description textuelle (requis) | -- |
--filename |
Nom du fichier de sortie (requis) | -- |
--model |
Modèle d'image | gemini_2.5_flash |
--ratio |
Rapport d'aspect. gemini_2.5_flash : 1344:768, 768:1344, 1024:1024, etc. gen4_image : 1280:720, 1360:768, 1920:1080, etc. |
Dépend du modèle (1344:768 pour gemini, 1280:720 pour les autres) |
--reference-images |
Images de référence en tant que paires tag=URL (optionnel pour gemini/gen4_image, requis pour gen4_image_turbo). Tag : minuscules, 3-16 caractères, par ex. product=URL |
-- |
--output-dir |
Répertoire de sortie | cwd |
Les identifiants API proviennent de
RUNWAYML_API_SECRETuniquement — pas de drapeau--api-key, pour garder les secrets hors de l'historique du shell et des listes de processus.
Convention de nommage des fichiers
Modèle : yyyy-mm-dd-hh-mm-ss-name.png
Exemples
Image basique :
uv run scripts/generate_image.py --prompt "A serene Japanese garden with cherry blossoms" --filename "2026-04-14-japanese-garden.png"Avec une image de référence locale (gen4_image) :
uv run scripts/generate_image.py --prompt "@product on a marble counter, lifestyle photo" --model gen4_image --reference-images product=./product.jpg --filename "2026-04-14-product-lifestyle.png"Avec une image de référence d'une source de confiance (gen4_image_turbo — requiert des images de référence) :
uv run scripts/generate_image.py --prompt "A neon sign reading SALE in @style" --model gen4_image_turbo --reference-images style=https://cdn.yourapp.com/style.jpg --filename "draft.png"Sortie
- Le script télécharge le résultat et le sauvegarde dans le chemin spécifié
- Le script affiche le chemin complet du fichier sauvegardé
- Ne relisez pas le fichier image — informez simplement l'utilisateur du chemin sauvegardé
Défaillances courantes
Error: No API key-> définissezRUNWAYML_API_SECRETdans l'environnement (par ex.export RUNWAYML_API_SECRET=...ou un fichier.env).Error: Task failed -- SAFETY.INPUT.*-> modération de contenu, suggérez un prompt différentAPI error 429-> limité en débit, le script réessaie automatiquement