> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Guide de démarrage rapide de l’API d’image Gemini : générer des images Nano Banana avec CometAPI
> Générez des images avec les modèles d’image Gemini via CometAPI, y compris les familles de modèles Nano Banana, et enregistrez la sortie inlineData avec curl, Python ou Node.js.
## Ce que vous allez créer
Vous appellerez la route Gemini image `generateContent` via CometAPI, demanderez une sortie image à partir des modèles d’image Gemini, y compris les familles de modèles Nano Banana, ignorerez les parties d’image `thought` intermédiaires et enregistrerez l’image finale `inlineData`.
## Prérequis
* Une clé API CometAPI stockée dans `COMETAPI_KEY`
* Python 3.10+ avec `requests`, ou Node.js 18+
* Un model ID de modèle d’image Gemini. La référence d’API maintenue utilise `gemini-3.1-flash-image-preview` comme exemple de texte vers image.
## Clé API, URL de base, authentification
Utilisez la route Gemini image via CometAPI :
```text theme={null}
https://api.cometapi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent
```
Authentifiez-vous avec `x-goog-api-key` :
```text theme={null}
x-goog-api-key: $COMETAPI_KEY
```
## Exemples de code
Utilisez les onglets ci-dessous pour des exemples copiables en cURL, Python et Node.js.
```bash cURL theme={null}
curl -s -X POST \
"https://api.cometapi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent" \
-H "x-goog-api-key: $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"parts": [
{
"text": "A Monarch butterfly anatomical sketch on textured parchment"
}
]
}
],
"generationConfig": {
"responseModalities": ["TEXT", "IMAGE"],
"imageConfig": {
"aspectRatio": "1:1",
"imageSize": "4K"
}
}
}'
```
```python Python theme={null}
import base64
import os
import requests
response = requests.post(
"https://api.cometapi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent",
headers={
"x-goog-api-key": os.environ["COMETAPI_KEY"],
"Content-Type": "application/json",
},
json={
"contents": [
{
"parts": [
{
"text": "A Monarch butterfly anatomical sketch on textured parchment"
}
]
}
],
"generationConfig": {
"responseModalities": ["TEXT", "IMAGE"],
"imageConfig": {"aspectRatio": "1:1", "imageSize": "4K"},
},
},
timeout=120,
)
response.raise_for_status()
parts = response.json()["candidates"][0]["content"]["parts"]
for part in reversed(parts):
if part.get("thought") is True:
continue
inline_data = part.get("inlineData")
if inline_data:
image_bytes = base64.b64decode(inline_data["data"])
mime_type = inline_data.get("mimeType", "image/png")
extension = "jpg" if mime_type == "image/jpeg" else "png"
with open(f"nano-banana-result.{extension}", "wb") as file:
file.write(image_bytes)
break
else:
raise RuntimeError("No final image part found")
```
```javascript Node.js theme={null}
import fs from "node:fs/promises";
const response = await fetch(
"https://api.cometapi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent",
{
method: "POST",
headers: {
"x-goog-api-key": process.env.COMETAPI_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
contents: [
{
parts: [
{
text: "A Monarch butterfly anatomical sketch on textured parchment",
},
],
},
],
generationConfig: {
responseModalities: ["TEXT", "IMAGE"],
imageConfig: { aspectRatio: "1:1", imageSize: "4K" },
},
}),
},
);
if (!response.ok) {
throw new Error(await response.text());
}
const body = await response.json();
const parts = body.candidates[0].content.parts;
const finalImage = [...parts]
.reverse()
.find((part) => part.thought !== true && part.inlineData);
if (!finalImage) {
throw new Error("No final image part found");
}
const mimeType = finalImage.inlineData.mimeType || "image/png";
const extension = mimeType === "image/jpeg" ? "jpg" : "png";
await fs.writeFile(
`nano-banana-result.${extension}`,
Buffer.from(finalImage.inlineData.data, "base64"),
);
```
## Explication du flux
La génération d’images Gemini est synchrone sur cette route. La réponse utilise la structure native Gemini `candidates[].content.parts[]`. Les parties peuvent inclure du texte, des images générées et des parties d’image intermédiaires où `thought` vaut `true`.
Lors de l’enregistrement du résultat, parcourez les parties d’image, ignorez `thought: true` et enregistrez la dernière image `inlineData` restante.
## Paramètres courants
| Parameter | Use |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `model` path segment | Model ID du modèle d’image Gemini dans le chemin de l’URL. |
| `contents` | Prompt et parties d’image d’entrée facultatives. |
| `generationConfig.responseModalities` | Incluez `IMAGE` lorsque vous avez besoin d’une sortie image. |
| `generationConfig.imageConfig` | Options d’image telles que le ratio d’aspect et la taille d’image lorsqu’elles sont prises en charge par le modèle sélectionné. |
| `tools` | Outils Gemini facultatifs. Ajoutez-les uniquement lorsque la référence d’API documente le workflow sélectionné. |
## Dépannage / FAQ
N’enregistrez pas les parties où `thought` vaut `true`. Ce sont des images intermédiaires, pas la sortie finale.
Vérifiez que `generationConfig.responseModalities` inclut `IMAGE` et que le modèle sélectionné prend en charge la sortie image.
Utilisez des parties de requête `inline_data` comme indiqué dans le guide des images Gemini, et conservez la même logique d’analyse de l’image finale.
## Étapes suivantes
* Lisez la [référence de l’API d’image Gemini](/api/image/gemini/gemini-generates-image).
* Consultez davantage d’exemples dans [Utiliser les modèles d’image Gemini](/api/image/gemini/generate-image-guide).
* Trouvez les modèles d’image disponibles dans [Models](/fr/overview/models).
* Estimez le coût avec [Estimer le coût d’une requête avant d’appeler un modèle](/fr/guides/how-to-estimate-cost-before-calling-a-model).