VisionCraft
Générez des images et des vidéos via les APIs Agnes AI. Appelle les scripts PowerShell dans scripts/. La clé API est lue depuis la variable d'environnement AGNES_API_KEY.
Première fois ? Voir Prérequis. Pour des conseils sur la rédaction de prompts et les détails des paramètres, voir
references/.
Référence rapide
| Tâche | Commande |
|---|---|
| Texte vers Image | scripts/gen_image.ps1 -Prompt "..." |
| Image vers Image | scripts/gen_image.ps1 -Prompt "..." -ImageUrl "https://..." |
| Texte vers Vidéo | scripts/gen_video.ps1 -Prompt "..." |
| Image vers Vidéo | scripts/gen_video.ps1 -Prompt "..." -Image "https://..." |
| Vidéo Multi-images | scripts/gen_video.ps1 -Prompt "..." -Image "https://a.png","https://b.png" |
| Animation Keyframes | scripts/gen_video.ps1 -Prompt "..." -Image "https://a.png","https://b.png" -Mode keyframes |
Par défaut : Images 2048x2048. Vidéos 1920x1080 @ 60 ips, 241 images (~4s).
Prérequis
Définissez la clé API une fois (persiste entre les sessions) :
[System.Environment]::SetEnvironmentVariable("AGNES_API_KEY", "sk-votre-clé-ici", "User")
Ou pour la session en cours uniquement :
$env:AGNES_API_KEY = "sk-votre-clé-ici"
Vérifiez avec echo $env:AGNES_API_KEY.
Comment utiliser ce skill
1. Identifier la demande
| L'utilisateur dit | Mode |
|---|---|
| "fais/dessine/génère une image de..." | Texte vers Image |
| "édite/transforme/restyle cette image..." (URL fournie) | Image vers Image |
| "fais une vidéo / anime / génère un clip de..." | Texte vers Vidéo |
| "anime cette photo / fais bouger cette image" (1 image) | Image vers Vidéo |
| "fusionne ces images en une vidéo" (plusieurs images) | Vidéo Multi-images |
| "transition fluide / morphing de A à B" (2+ images) | Animation Keyframes |
2. Affiner le prompt si nécessaire
Si la demande est vague, suggérez brièvement un prompt plus riche avant d'exécuter. Pour la structure du prompt et les bonnes pratiques, voir references/prompt-guide.md.
3. Exécuter le script
Passez le ratio d'aspect avec -Ratio et la durée avec -Seconds pour le contrôle le plus simple. Voir references/parameters.md pour tous les paramètres.
# Exemples :
scripts/gen_image.ps1 -Prompt "..." -Ratio 16:9
scripts/gen_video.ps1 -Prompt "..." -Ratio 9:16 -Seconds 8
4. Afficher le résultat
Les scripts impriment une ligne MEDIA:<url> en cas de succès. Toujours afficher l'URL sur sa propre ligne — ne l'enterrez jamais dans un paragraphe. Si la plateforme prend en charge le rendu média intégré, intégrez-le ; sinon, l'URL seule suffit.
Ne jamais télécharger le résultat sur le disque local sauf demande explicite de l'utilisateur.
Format de sortie
Image :
✅ Image générée.
MEDIA:https://platform-outputs.agnes-ai.space/images/...
Vidéo :
🎬 Vidéo générée (4,0s, 1920x1080).
MEDIA:https://platform-outputs.agnes-ai.space/videos/...
Erreurs et dépannage
| Erreur | Correction |
|---|---|
AGNES_API_KEY not set | Définissez-la (voir Prérequis). Redémarrez le terminal si nécessaire. |
| 401 Non autorisé | Clé API invalide ou expirée. |
| 400 Mauvaise requête | Vérifiez le prompt, le format de taille, la règle de nombre d'images (8n+1, ≤441). |
| 503 Service indisponible | Service occupé. Attendez 30s, réessayez. |
| Délai d'attente vidéo (15 min) | Le script imprime le video_id — interrogez à nouveau plus tard, la tâche n'est pas abandonnée. |
Pour le comportement complet de l'API, voir references/api_docs.md.
Fichiers de référence
references/api_docs.md— spécification complète de l'API Agnesreferences/prompt-guide.md— structure du prompt pour image et vidéoreferences/parameters.md— tous les paramètres de script, avec exemples