Guide complet de la sortie aux proportions originales de l’API Nano Banana Pro : 3 scénarios pour générer des images en taille réelle

Note de l'auteur : Explication détaillée sur la manière d'obtenir une sortie aux dimensions originales avec l'API Nano Banana Pro, en maîtrisant l'astuce de l'omission du paramètre aspect_ratio pour résoudre les problèmes de conservation de taille lors de l'édition d'images.

Lorsqu'on utilise l'API Nano Banana Pro pour éditer des images, conserver les dimensions de l'image d'origine est un défi fréquent pour les développeurs. La documentation officielle limite explicitement aspect_ratio à 10 formats fixes, mais il existe en réalité une solution simple : en mode édition, il suffit d'omettre le paramètre aspect_ratio pour obtenir une sortie aux dimensions d'origine.

Valeur ajoutée : En lisant cet article, vous maîtriserez la technique complète pour obtenir des sorties au format original via l'API Nano Banana Pro et apprendrez à contrôler les dimensions de vos images de manière flexible selon les scénarios.

Points clés de la sortie au format original Nano Banana Pro

Le principe clé de la sortie au format original avec Nano Banana Pro

Nano Banana Pro (c'est-à-dire Gemini 3 Pro Image) présente deux comportements par défaut distincts lors du traitement des images. Pour les scénarios de génération pure à partir de texte (text-to-image), si vous ne spécifiez pas aspect_ratio, l'API produira par défaut une image carrée de format 1:1.

En revanche, dans un scénario d'édition d'image (image-to-image), le comportement de l'API change radicalement. Lorsque vous fournissez une image de référence pour la modifier, si vous omettez le paramètre aspect_ratio, l'API identifie automatiquement les dimensions d'origine de l'image d'entrée et génère le résultat avec ces mêmes dimensions. C'est le mécanisme central pour garantir une sortie fidèle au format original.

Pourquoi cette approche est-elle efficace ?

Cette conception est logique : lorsqu'un utilisateur télécharge une image pour l'éditer, il s'attend généralement à ce que l'image de sortie conserve les mêmes dimensions et proportions que l'originale. Forcer l'utilisateur à calculer et spécifier manuellement un ratio augmenterait non seulement la complexité du développement, mais pourrait également entraîner des déformations ou des recadrages indésirables si le ratio ne correspond pas parfaitement.

Détails des règles officielles de sortie au format original pour Nano Banana Pro

La documentation officielle de l'API stipule clairement que le paramètre aspect_ratio n'accepte que les 10 valeurs prédéfinies suivantes :

Note importante : Les limites de ratio mentionnées ci-dessus s'appliquent uniquement aux scénarios nécessitant une taille spécifique. Pour l'édition d'images, il est recommandé d'effectuer des tests via la plateforme APIYI (apiyi.com) : il suffit d'omettre le paramètre aspect_ratio pour obtenir une sortie aux dimensions originales.

Démarrage rapide : Sortie au format original avec Nano Banana Pro

Exemple minimaliste : Conserver la taille originale lors de l'édition d'image

Voici la méthode la plus simple pour implémenter une sortie au format original :

import openai
import base64

client = openai.OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://vip.apiyi.com/v1"
)

# Lecture et encodage de l'image source
with open("input.jpg", "rb") as f:
    image_base64 = base64.b64encode(f.read()).decode()

# Crucial : ne pas passer le paramètre aspect_ratio
response = client.chat.completions.create(
    model="gemini-3-pro-image-preview",
    messages=[{
        "role": "user",
        "content": [
            {"type": "image_url", "image_url": {"url": f"data:image/jpeg;base64,{image_base64}"}},
            {"type": "text", "text": "Transformer l'arrière-plan de l'image en un coucher de soleil"}
        ]
    }]
)

import openai
import base64
from pathlib import Path

def edit_image_keep_ratio(
    image_path: str,
    edit_prompt: str,
    output_path: str = "output.png"
) -> bool:
    """
    Édite une image en conservant ses dimensions d'origine

    Args:
        image_path: Chemin de l'image d'entrée
        edit_prompt: Instruction d'édition
        output_path: Chemin de l'image de sortie

    Returns:
        Succès ou échec
    """
    client = openai.OpenAI(
        api_key="YOUR_API_KEY",
        base_url="https://vip.apiyi.com/v1"
    )

    # Lecture et encodage de l'image
    image_data = Path(image_path).read_bytes()
    image_base64 = base64.b64encode(image_data).decode()

    # Détection du format de l'image
    suffix = Path(image_path).suffix.lower()
    mime_type = {"jpg": "jpeg", "jpeg": "jpeg", "png": "png", "webp": "webp"}.get(suffix[1:], "jpeg")

    try:
        # Cœur du processus : pas d'aspect_ratio, conservation automatique des dimensions
        response = client.chat.completions.create(
            model="gemini-3-pro-image-preview",
            messages=[{
                "role": "user",
                "content": [
                    {"type": "image_url", "image_url": {"url": f"data:image/{mime_type};base64,{image_base64}"}},
                    {"type": "text", "text": edit_prompt}
                ]
            }]
        )

        # Sauvegarde du résultat
        result_base64 = response.choices[0].message.content
        output_data = base64.b64decode(result_base64)
        Path(output_path).write_bytes(output_data)
        return True

    except Exception as e:
        print(f"Échec de l'édition : {e}")
        return False

# Exemple d'utilisation
edit_image_keep_ratio(
    "product.jpg",
    "Supprimer l'arrière-plan de l'image et ne garder que le produit principal",
    "product_nobg.png"
)

Conseil : Obtenez des crédits de test gratuits sur APIYI (apiyi.com) pour vérifier rapidement le rendu en format original. La plateforme prend en charge l'intégralité des fonctionnalités du modèle Nano Banana Pro.

Comparaison de trois scénarios de sortie au format original avec Nano Banana Pro

Scénario 1 : Texte-en-image avec ratio spécifique

Lors de la génération d'une image à partir d'un simple texte, si vous avez besoin de dimensions particulières, vous devez impérativement passer le paramètre aspect_ratio :

response = client.chat.completions.create(
    model="gemini-3-pro-image-preview",
    messages=[{"role": "user", "content": "一只可爱的猫咪"}],
    extra_body={
        "image_config": {
            "aspect_ratio": "16:9",  # 必须指定
            "resolution": "2K"
        }
    }
)

Scénario 2 : Édition d'image en conservant la taille originale

C'est le point central de cet article : il suffit d'omettre le paramètre aspect_ratio pour garder le format source :

response = client.chat.completions.create(
    model="gemini-3-pro-image-preview",
    messages=[{
        "role": "user",
        "content": [
            {"type": "image_url", "image_url": {"url": f"data:image/jpeg;base64,{img}"}},
            {"type": "text", "text": "增强图片色彩"}
        ]
    }]
    # 不传 extra_body 或 aspect_ratio
)

Scénario 3 : Édition d'image en forçant le changement de ratio

Si vous devez réellement modifier les proportions lors de l'édition, vous pouvez alors passer le paramètre explicitement :

response = client.chat.completions.create(
    model="gemini-3-pro-image-preview",
    messages=[{
        "role": "user",
        "content": [
            {"type": "image_url", "image_url": {"url": f"data:image/jpeg;base64,{img}"}},
            {"type": "text", "text": "将图片改为正方形构图"}
        ]
    }],
    extra_body={"image_config": {"aspect_ratio": "1:1"}}
)

Note comparative : Les configurations de paramètres ci-dessus ont été vérifiées sur la plateforme APIYI (apiyi.com) et sont opérationnelles.

FAQ

Conclusion

Voici les points clés à retenir pour la sortie au format original avec Nano Banana Pro :

1. L'omission équivaut au format d'origine : Dans un contexte d'édition d'image, ne pas envoyer le paramètre aspect_ratio permet de conserver les dimensions de l'image source.
2. Bien distinguer les scénarios : La génération à partir de texte est en 1:1 par défaut, alors que la modification d'image conserve par défaut le format original. Les deux modes ont des comportements différents.
3. 10 ratios prédéfinis : Si vous devez absolument spécifier une taille, vous devrez choisir parmi les 10 ratios officiellement supportés.

Une fois cette astuce maîtrisée, vous pourrez facilement gérer l'édition de photos de produits, la retouche de portraits ou le remplacement d'arrière-plan sans vous soucier des problèmes de redimensionnement en post-production.

N'hésitez pas à tester tout cela via APIYI (apiyi.com). La plateforme propose des crédits gratuits et une prise en charge complète du modèle Nano Banana Pro.

📚 Références

⚠️ Note sur le format des liens : Tous les liens externes utilisent le format Nom de la ressource : domain.com. Ce format facilite le copier-coller tout en évitant la perte de poids SEO (liens non cliquables).

1. Documentation officielle de l'API Google Gemini : Description complète des paramètres pour la génération d'images Nano Banana

   • Lien : ai.google.dev/gemini-api/docs/nanobanana
   • Description : Documentation officielle de référence, incluant la définition complète du paramètre aspect_ratio.

2. API fal.ai Nano Banana Pro : Documentation détaillée de l'interface sur plateforme tierce

   • Lien : fal.ai/models/fal-ai/nano-banana-pro/edit/api
   • Description : Contient des exemples de configuration de paramètres pour les scénarios image-to-image.

3. Forum des développeurs Google AI : Discussions communautaires et FAQ

   • Lien : discuss.ai.google.dev
   • Description : Pour retrouver les retours d'expérience d'autres développeurs sur le contrôle des dimensions.

Auteur : Équipe technique
Échanges techniques : N'hésitez pas à discuter des astuces d'utilisation de l'API Nano Banana Pro dans l'espace commentaires. Pour plus de ressources, rendez-vous sur la communauté technique APIYI sur apiyi.com.