Référence API pour génération/édition d’images

Référence des interfaces de la série Nano Banana (modèles d’images de l’écosystème Gemini). Pour une présentation de la série et des conseils de prompt, voir Nano Banana 生图。

Génération d’images à partir de texte

POST https://api.4allapi.com/v1/images/generations

curl https://api.4allapi.com/v1/images/generations \
  -H "Authorization: Bearer $AIPROXY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-portrait",
    "prompt": "Portrait au rendu de couverture de magazine, lumière naturelle, faible profondeur de champ, avec le texte \"OMNI\" en bas de l’image"
  }'

Les formats et résolutions utilisent les suffixes du modèle : -square / -portrait / -landscape / -three-four / -four-three, et -2k pour la haute définition ;
Les séries Gemini excellent dans le rendu du texte dans l’image ; écrivez le contenu textuel entre guillemets dans le prompt.

Édition d’image (image-à-image)

POST https://api.4allapi.com/v1/images/edits

curl https://api.4allapi.com/v1/images/edits \
  -H "Authorization: Bearer $AIPROXY_KEY" \
  -F model="gemini-3.1-flash-image" \
  -F image="@ref.png" \
  -F prompt="Transformer la même personne en photo en pied dans un décor hivernal enneigé, en conservant les traits du visage"

Pour plusieurs images de référence, transmettez plusieurs champs image dans l’ordre ; précisez dans le prompt le rôle de chaque image (image principale / image de style) ;
Pour les scènes où la cohérence de la personne / du produit est primordiale, privilégiez l’interface d’édition plutôt qu’une nouvelle génération d’image à partir de texte.

Niveaux de modèles

Niveau	Modèle représentatif	Caractéristiques
Pro	série `gemini-3.0-pro-image`	Qualité maximale, détails et texte les plus stables
Standard	série `gemini-3.1-flash-image`	Bon équilibre qualité / vitesse, niveau principal
Aperçu	`gemini-3-pro-image`	Nouveautés en avant-première

Les modèles disponibles en temps réel et leur tarif unitaire se réfèrent au模型广场； La structure de réponse et les précautions de transfert sont les mêmes que dans 文生图 API 参考。