Génération d'Images
Générer des images IA via submit_image (uniquement les clés des fournisseurs configurés). Privilégier une seule image fixe par requête, sauf si l'utilisateur demande des variantes.
Sélection du Modèle
| Modèle | Référence | Points forts | Max références |
|---|---|---|---|
fal + falModel | references/fal.md | Catalogue explicite de Fal ; voir le schéma de l'outil pour les limites par modèle | Par modèle |
gpt-image-2 | references/gpt-image-2.md | Meilleur rendu texte, meilleure adhérence au prompt | 16 |
nano-banana | references/nano-banana.md | Meilleure fidélité aux images de référence | 14 |
image-01 | references/image-01.md | Images fixes / style live MiniMax ; une référence sujet via R2 | 1 |
grok-imagine | references/grok-imagine.md | xAI Grok Imagine ; texte-à-image, ≤4 sorties, 1K/2K | 0 |
- Si Fal.ai est sélectionné ou demandé, utiliser
model: "fal"et lefalModeldemandé ou la valeur par défaut de Fal sauvegardée dans les capacités. Demander si aucun n'est sélectionné. Les valeurs par défaut et contrôles des fournisseurs natifs ci-dessous ne s'appliquent pas à Fal. - Par défaut :
gpt-image-2lorsque cette clé est activée. - Beaucoup de références →
nano-banana. - Utilisateur a nommé MiniMax / seule la clé image MiniMax est activée →
image-01. - Respecter les capacités : ne pas appeler un modèle dont le fournisseur n'est pas configuré.
IMPORTANT : Avant de générer, LIRE la référence du modèle choisi.
Paramètres de l'Outil
| Paramètre | Valeurs | Défaut |
|---|---|---|
aspectRatio | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 4:5, 5:4, 21:9 | 16:9 |
imageSize | 512px, 1K, 2K, 4K (spécifique au modèle) | 1K |
width / height | GPT Image : 512–3840, /16 ; MiniMax : 512–2048, /8 | — |
quality | low, medium, high, auto (gpt-image-2 uniquement) | high |
referenceAssetIds | Tableau des identifiants d'actifs du projet — le backend résout les octets côté serveur | — |
name | Nom d'actif court et descriptif affiché dans la bibliothèque | — |
count | Nombre d'images à générer (1–10 ; image-01 max 9) | 1 |
promptOptimizer | MiniMax image-01 uniquement — prompt_optimizer | false |
seed | MiniMax image-01 uniquement | — |
maskAssetId, background, moderation, inputFidelity | Contrôles d'édition/sortie de GPT Image | — |
outputFormat, outputCompression | Contrôles PNG/JPEG/WebP de GPT Image | PNG |
Valeurs par Défaut
- Rapport hauteur/largeur : 16:9. Si la composition du projet n'est pas en 16:9, DEMANDER à l'utilisateur quel rapport il souhaite avant de générer.
- Taille : 1K.
Demander Avant de Soumettre
- Ne jamais augmenter automatiquement la taille.
- Ne passer
imageSize: "2K"ou"4K"que lorsque l'utilisateur le demande explicitement. Prévenir que 2K/4K sont EXPÉRIMENTAUX et peuvent être plus lents.
Images de Référence
Utiliser lorsque l'utilisateur fournit une source à modifier, fusionner ou utiliser comme guide visuel (ex. "changer le fond", "combiner ceci en une affiche").
- Passer les identifiants des actifs du projet via
referenceAssetIds. Le backend les récupère et les encode côté serveur — ne jamais récupérer les octets vous-même. - Lorsque l'utilisateur @-référence un actif image, passer directement son identifiant dans
referenceAssetIds. - Formats acceptés par le backend : png, jpeg, webp, svg (automatiquement rastérisé en png), heic, heif. Chaque fichier ≤ 50 Mo.
Exécution
// Génération de base
submit_image({
model: "gpt-image-2",
prompt: "un joli chat orange",
name: "Chat",
});
// Avec qualité (gpt-image-2 uniquement)
submit_image({
model: "gpt-image-2",
prompt: "affiche héroïque avec titre en gras",
quality: "high",
name: "Affiche Héroïque",
});
// Avec images de référence — passer les identifiants des actifs ; le backend résout les octets
submit_image({
model: "gpt-image-2",
prompt: "changer le fond pour une plage",
referenceAssetIds: ["<assetId>"],
name: "Édition Plage",
});
// Beaucoup de références avec nano-banana
submit_image({
model: "nano-banana",
prompt: "affiche composite",
referenceAssetIds: ["<id1>", "<id2>"],
name: "Composite",
});
// Plusieurs images
submit_image({
model: "gpt-image-2",
prompt: "prises de vue produit",
count: 3,
name: "Produit",
});
// MiniMax (référence sujet unique facultative ; R2 doit être configuré pour les références)
submit_image({
model: "image-01",
prompt: "bouteille produit mate sur marbre, lumière studio douce",
name: "Nature morte bouteille",
promptOptimizer: false,
});
submit_image d'OpenChatCut peut retourner des actifs de pool terminés de manière synchrone selon le chemin du fournisseur. Si un jobId est retourné, utiliser track_progress ; sinon, traiter les identifiants d'actifs dans le résultat comme terminés.
Règles
- Toujours fournir
nameavec un nom d'actif court et descriptif. - Avant de soumettre, informer brièvement l'utilisateur de ce qui va être généré — surtout lors de la génération de plusieurs images.
- N'appeler que les modèles dont la clé du fournisseur est configurée (capacités du prompt).