Générer des images avec Auteo
Utilise le CLI auteo (npm i -g @auteo/cli, puis auteo auth login). Si une commande se termine avec le code 3, suivez la compétence auteo-account pour vous connecter d'abord. Les utilisateurs MCP peuvent faire de même avec les outils auteo_* listés à la fin.
1. Choisir un modèle
auteo model list --type text_to_image --json # ou --type image_to_image pour les éditions
auteo model get <model> --json # tous les paramètres, options et contraintes
Toujours lire model get avant de générer : les ratios d'aspect et les niveaux de résolution diffèrent selon le modèle, et resolutionsByAspectRatio indique quels niveaux chaque ratio autorise.
Guide approximatif (vérifiez la liste en direct, elle change) :
| Besoin | Bon premier choix |
|---|---|
| Meilleure qualité globale, texte dans les images | openai/gpt-image-2-6-sunburst, google/nano-banana-pro |
| Brouillons rapides et économiques | google/nano-banana, alibaba/z-image |
| Éditer une photo avec images de référence | google/nano-banana-2, bytedance/seedream-5-5 |
| Gratuit pour les abonnés Plus / Ultra | modèles avec subscriberUnlimited: true (ex. alibaba/z-image) |
2. Choisir les paramètres
--aspect-ratioest requis. Utilisez ce que l'utilisateur demande ; sinon1:1pour les avatars et icônes,16:9pour les bannières et miniatures,9:16pour les stories,3:4pour les portraits. Certains modèles proposent aussiauto.--resolutionest requis lorsque le modèle a des niveaux (1K/2K/4K). Les niveaux supérieurs coûtent plus cher. Par défaut1Kpour les brouillons ; n'augmentez que si l'utilisateur souhaite une impression ou un grand écran, et précisez que cela coûte plus.--n(1–4) permet plusieurs variations ; chacune est facturée.--image <chemin|url-https>(répétable) ajoute des images de référence pour l'édition ou le style. Les fichiers locaux sont téléchargés ; le nombre autorisé est indiqué dansmodel get(inputAssetIds.max).- Rédigez le prompt en anglais sauf si l'utilisateur souhaite du texte dans une autre langue rendu dans l'image.
3. Vérifier le prix, puis générer
auteo generate cost google/nano-banana-2 --aspect-ratio 16:9 --resolution 2K --json
auteo generate create google/nano-banana-2 --prompt "un renard roux dans la neige fraîche, lumière cinématographique" \
--aspect-ratio 16:9 --resolution 2K --out ./images --json
--out <dossier> attend le résultat et télécharge les fichiers ; le JSON liste files et outputs[].url. Sans --out/--wait la commande renvoie immédiatement un requestId ; récupérez-le plus tard avec auteo generate wait <requestId> --out ./images.
Informez l'utilisateur des chemins des fichiers et des crédits dépensés (cost).
En cas d'échec
- Code 4, crédits insuffisants : arrêtez et suivez la compétence auteo-account (indiquez à l'utilisateur le prix et le solde, lien pour recharger). Ne réduisez pas les paramètres de votre propre chef.
- Code 2, paramètres invalides : relisez
auteo model get <model>et corrigez la combinaison ratio/niveau. - Code 5, prompt rejeté par la modération : reformulez le prompt sans le contenu signalé ; renvoyer le même prompt échouera à nouveau.
- Code 6, limite : trop de générations en cours ou trop de soumissions ; attendez et réessayez.
- Timeout ou erreur réseau lors de
create: ne soumettez pas à nouveau aveuglément. Exécutezauteo generate list --type image --limit 5 --json; si la demande n'est pas présente, réessayez avec--client-request-id <l'id imprimé avant>pour qu'elle ne soit pas facturée deux fois. status: faileddans le résultat : signalezerrorMessage; sisuggestedModelest défini, proposez-le à l'utilisateur.
Outils MCP
auteo_list_models, auteo_get_model, auteo_estimate_cost, auteo_upload_image (renvoie un assetId pour inputAssetIds), auteo_generate_image, auteo_get_generation (rappeler après pollAfterMs jusqu'à done), auteo_list_generations.