> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Génération d’images avec Gemini 3.1 Flash

Utilisez le modèle Gemini 3.1 Flash Image Preview pour générer des images à partir d’invites textuelles. Prend en charge des dimensions d’image, des rapports largeur/hauteur et une profondeur de réflexion configurables afin d’obtenir des résultats de génération de meilleure qualité.

## En-têtes de requête

<ParamField header="Content-Type" type="string" required={true}>
  Valeur d’énumération : `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Format d’authentification Bearer : Bearer \{\{clé API}}.
</ParamField>

## Corps de la requête

<ParamField body="size" type="string" default="1K">
  Dimensions en pixels de l’image de sortie (largeur\*hauteur). 0.5K (512 px) ne s’applique qu’à Gemini 3.1 Flash.

  Valeurs possibles : `0.5K`, `1K`, `2K`, `4K`
</ParamField>

<ParamField body="google" type="object">
  Options de recherche Google

  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="web_search" type="boolean" default={false}>
      Active la recherche Web Google afin de générer des images plus précises à partir d’informations du monde réel.
    </ParamField>

    <ParamField body="image_search" type="boolean" default={false}>
      Active la recherche d’images Google afin d’utiliser de vraies images comme références visuelles pour la génération.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  Invite textuelle décrivant l’image à générer
</ParamField>

<ParamField body="aspect_ratio" type="string" default="1:1">
  Rapport largeur/hauteur de l’image générée.

  Valeurs possibles : `1:1`, `1:4`, `1:8`, `2:3`, `3:2`, `3:4`, `4:1`, `4:3`, `4:5`, `5:4`, `8:1`, `9:16`, `16:9`, `21:9`
</ParamField>

<ParamField body="output_format" type="string" default="image/png">
  Type MIME de l’image de sortie, prend en charge les formats PNG et JPEG.

  Valeurs possibles : `image/png`, `image/jpeg`
</ParamField>

## Informations de réponse

<ResponseField name="image_urls" type="string[]" required={true}>
  Liste des URL des images générées
</ResponseField>

<ResponseField name="grounding_metadata" type="object" required={false}>
  Métadonnées de grounding du modèle. Retournées lorsque des outils côté serveur Google (par exemple, la recherche) sont appelés. Remarque : l’appel d’outils dépend de Google. L’activation des outils via des paramètres ne déclenche pas nécessairement un appel d’outil dans 100 % des cas.
</ResponseField>