API Gemini de retouche d’images

curl --request POST \
  --url https://bettertoken.ai/v1beta/models/{model}:generateContent \
  --header 'Content-Type: application/json' \
  --header 'x-goog-api-key: <api-key>' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Rends la tasse rouge. Conserve sa forme, le fond et l’éclairage."
        },
        {
          "inlineData": {
            "mimeType": "image/png",
            "data": "REPLACE_WITH_IMAGE_BASE64"
          }
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "IMAGE"
    ],
    "candidateCount": 1,
    "imageConfig": {
      "imageSize": "1K",
      "aspectRatio": "1:1"
    }
  }
}
'

import requests

url = "https://bettertoken.ai/v1beta/models/{model}:generateContent"

payload = {
    "contents": [
        {
            "role": "user",
            "parts": [{ "text": "Rends la tasse rouge. Conserve sa forme, le fond et l’éclairage." }, { "inlineData": {
                        "mimeType": "image/png",
                        "data": "REPLACE_WITH_IMAGE_BASE64"
                    } }]
        }
    ],
    "generationConfig": {
        "responseModalities": ["IMAGE"],
        "candidateCount": 1,
        "imageConfig": {
            "imageSize": "1K",
            "aspectRatio": "1:1"
        }
    }
}
headers = {
    "x-goog-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-goog-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    contents: [
      {
        role: 'user',
        parts: [
          {text: 'Rends la tasse rouge. Conserve sa forme, le fond et l’éclairage.'},
          {inlineData: {mimeType: 'image/png', data: 'REPLACE_WITH_IMAGE_BASE64'}}
        ]
      }
    ],
    generationConfig: {
      responseModalities: ['IMAGE'],
      candidateCount: 1,
      imageConfig: {imageSize: '1K', aspectRatio: '1:1'}
    }
  })
};

fetch('https://bettertoken.ai/v1beta/models/{model}:generateContent', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://bettertoken.ai/v1beta/models/{model}:generateContent",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'contents' => [
        [
                'role' => 'user',
                'parts' => [
                                [
                                                                'text' => 'Rends la tasse rouge. Conserve sa forme, le fond et l’éclairage.'
                                ],
                                [
                                                                'inlineData' => [
                                                                                                                                'mimeType' => 'image/png',
                                                                                                                                'data' => 'REPLACE_WITH_IMAGE_BASE64'
                                                                ]
                                ]
                ]
        ]
    ],
    'generationConfig' => [
        'responseModalities' => [
                'IMAGE'
        ],
        'candidateCount' => 1,
        'imageConfig' => [
                'imageSize' => '1K',
                'aspectRatio' => '1:1'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-goog-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://bettertoken.ai/v1beta/models/{model}:generateContent"

	payload := strings.NewReader("{\n  \"contents\": [\n    {\n      \"role\": \"user\",\n      \"parts\": [\n        {\n          \"text\": \"Rends la tasse rouge. Conserve sa forme, le fond et l’éclairage.\"\n        },\n        {\n          \"inlineData\": {\n            \"mimeType\": \"image/png\",\n            \"data\": \"REPLACE_WITH_IMAGE_BASE64\"\n          }\n        }\n      ]\n    }\n  ],\n  \"generationConfig\": {\n    \"responseModalities\": [\n      \"IMAGE\"\n    ],\n    \"candidateCount\": 1,\n    \"imageConfig\": {\n      \"imageSize\": \"1K\",\n      \"aspectRatio\": \"1:1\"\n    }\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-goog-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://bettertoken.ai/v1beta/models/{model}:generateContent")
  .header("x-goog-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"contents\": [\n    {\n      \"role\": \"user\",\n      \"parts\": [\n        {\n          \"text\": \"Rends la tasse rouge. Conserve sa forme, le fond et l’éclairage.\"\n        },\n        {\n          \"inlineData\": {\n            \"mimeType\": \"image/png\",\n            \"data\": \"REPLACE_WITH_IMAGE_BASE64\"\n          }\n        }\n      ]\n    }\n  ],\n  \"generationConfig\": {\n    \"responseModalities\": [\n      \"IMAGE\"\n    ],\n    \"candidateCount\": 1,\n    \"imageConfig\": {\n      \"imageSize\": \"1K\",\n      \"aspectRatio\": \"1:1\"\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://bettertoken.ai/v1beta/models/{model}:generateContent")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-goog-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"contents\": [\n    {\n      \"role\": \"user\",\n      \"parts\": [\n        {\n          \"text\": \"Rends la tasse rouge. Conserve sa forme, le fond et l’éclairage.\"\n        },\n        {\n          \"inlineData\": {\n            \"mimeType\": \"image/png\",\n            \"data\": \"REPLACE_WITH_IMAGE_BASE64\"\n          }\n        }\n      ]\n    }\n  ],\n  \"generationConfig\": {\n    \"responseModalities\": [\n      \"IMAGE\"\n    ],\n    \"candidateCount\": 1,\n    \"imageConfig\": {\n      \"imageSize\": \"1K\",\n      \"aspectRatio\": \"1:1\"\n    }\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "BASE64_IMAGE_DATA"
            }
          }
        ]
      },
      "finishReason": "STOP"
    }
  ]
}

POST

v1beta

models

{model}

:generateContent

API Gemini de retouche d’images

curl --request POST \
  --url https://bettertoken.ai/v1beta/models/{model}:generateContent \
  --header 'Content-Type: application/json' \
  --header 'x-goog-api-key: <api-key>' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Rends la tasse rouge. Conserve sa forme, le fond et l’éclairage."
        },
        {
          "inlineData": {
            "mimeType": "image/png",
            "data": "REPLACE_WITH_IMAGE_BASE64"
          }
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "IMAGE"
    ],
    "candidateCount": 1,
    "imageConfig": {
      "imageSize": "1K",
      "aspectRatio": "1:1"
    }
  }
}
'

import requests

url = "https://bettertoken.ai/v1beta/models/{model}:generateContent"

payload = {
    "contents": [
        {
            "role": "user",
            "parts": [{ "text": "Rends la tasse rouge. Conserve sa forme, le fond et l’éclairage." }, { "inlineData": {
                        "mimeType": "image/png",
                        "data": "REPLACE_WITH_IMAGE_BASE64"
                    } }]
        }
    ],
    "generationConfig": {
        "responseModalities": ["IMAGE"],
        "candidateCount": 1,
        "imageConfig": {
            "imageSize": "1K",
            "aspectRatio": "1:1"
        }
    }
}
headers = {
    "x-goog-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-goog-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    contents: [
      {
        role: 'user',
        parts: [
          {text: 'Rends la tasse rouge. Conserve sa forme, le fond et l’éclairage.'},
          {inlineData: {mimeType: 'image/png', data: 'REPLACE_WITH_IMAGE_BASE64'}}
        ]
      }
    ],
    generationConfig: {
      responseModalities: ['IMAGE'],
      candidateCount: 1,
      imageConfig: {imageSize: '1K', aspectRatio: '1:1'}
    }
  })
};

fetch('https://bettertoken.ai/v1beta/models/{model}:generateContent', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://bettertoken.ai/v1beta/models/{model}:generateContent",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'contents' => [
        [
                'role' => 'user',
                'parts' => [
                                [
                                                                'text' => 'Rends la tasse rouge. Conserve sa forme, le fond et l’éclairage.'
                                ],
                                [
                                                                'inlineData' => [
                                                                                                                                'mimeType' => 'image/png',
                                                                                                                                'data' => 'REPLACE_WITH_IMAGE_BASE64'
                                                                ]
                                ]
                ]
        ]
    ],
    'generationConfig' => [
        'responseModalities' => [
                'IMAGE'
        ],
        'candidateCount' => 1,
        'imageConfig' => [
                'imageSize' => '1K',
                'aspectRatio' => '1:1'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-goog-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://bettertoken.ai/v1beta/models/{model}:generateContent"

	payload := strings.NewReader("{\n  \"contents\": [\n    {\n      \"role\": \"user\",\n      \"parts\": [\n        {\n          \"text\": \"Rends la tasse rouge. Conserve sa forme, le fond et l’éclairage.\"\n        },\n        {\n          \"inlineData\": {\n            \"mimeType\": \"image/png\",\n            \"data\": \"REPLACE_WITH_IMAGE_BASE64\"\n          }\n        }\n      ]\n    }\n  ],\n  \"generationConfig\": {\n    \"responseModalities\": [\n      \"IMAGE\"\n    ],\n    \"candidateCount\": 1,\n    \"imageConfig\": {\n      \"imageSize\": \"1K\",\n      \"aspectRatio\": \"1:1\"\n    }\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-goog-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://bettertoken.ai/v1beta/models/{model}:generateContent")
  .header("x-goog-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"contents\": [\n    {\n      \"role\": \"user\",\n      \"parts\": [\n        {\n          \"text\": \"Rends la tasse rouge. Conserve sa forme, le fond et l’éclairage.\"\n        },\n        {\n          \"inlineData\": {\n            \"mimeType\": \"image/png\",\n            \"data\": \"REPLACE_WITH_IMAGE_BASE64\"\n          }\n        }\n      ]\n    }\n  ],\n  \"generationConfig\": {\n    \"responseModalities\": [\n      \"IMAGE\"\n    ],\n    \"candidateCount\": 1,\n    \"imageConfig\": {\n      \"imageSize\": \"1K\",\n      \"aspectRatio\": \"1:1\"\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://bettertoken.ai/v1beta/models/{model}:generateContent")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-goog-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"contents\": [\n    {\n      \"role\": \"user\",\n      \"parts\": [\n        {\n          \"text\": \"Rends la tasse rouge. Conserve sa forme, le fond et l’éclairage.\"\n        },\n        {\n          \"inlineData\": {\n            \"mimeType\": \"image/png\",\n            \"data\": \"REPLACE_WITH_IMAGE_BASE64\"\n          }\n        }\n      ]\n    }\n  ],\n  \"generationConfig\": {\n    \"responseModalities\": [\n      \"IMAGE\"\n    ],\n    \"candidateCount\": 1,\n    \"imageConfig\": {\n      \"imageSize\": \"1K\",\n      \"aspectRatio\": \"1:1\"\n    }\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "BASE64_IMAGE_DATA"
            }
          }
        ]
      },
      "finishReason": "STOP"
    }
  ]
}

Envoyez une référence et une consigne à Nano Banana Pro, 2 ou 2.1 pour obtenir une image retouchée. POST /v1beta/models/{model}:generateContent La génération par texte et la retouche utilisent le même endpoint. La retouche ajoute une image de référence à la requête.

Préparer les références

Placez le texte et chaque image dans des éléments distincts. inlineData.data contient le base64 brut sans préfixe Data URL. Utilisez des références PNG ou JPEG ; cet endpoint accepte du JSON, pas de multipart ni d’URL d’image. Avant l’envoi, remplacez REPLACE_WITH_IMAGE_BASE64 par le base64 de votre image et adaptez inlineData.mimeType au fichier. L’instruction d’exemple décrit une tasse ; modifiez-la si votre sujet est différent.

Tester une requête

Préparez d’abord la référence. Saisissez BetterToken API Key dans x-goog-api-key et choisissez model. Dans contents, indiquez l’instruction et les données de l’image. Vérifiez que inlineData.data a été remplacé et que inlineData.mimeType correspond au fichier, puis cliquez sur Send.

Cliquer sur Send envoie une véritable requête de génération susceptible d’être facturée. Attendez la réponse synchrone. Après une expiration ou une déconnexion, vérifiez la consommation et le résultat avant de renvoyer la requête.

Les trois proposent 1K, 2K et 4K. Nano Banana 2 et 2.1 prennent en charge 14 proportions, Pro en propose 10. X-BetterToken-Max-Images plafonne les images livrées et facturées sans en garantir le nombre. Proportions

BetterToken API ne prend pas en charge la génération avec recherche, y compris Google Web Search et Image Search grounding. N’ajoutez pas d’outils de recherche.

Utilisez generateContent sans streaming. Cette intégration ne prend pas en charge Files / fileData, Batch, Interactions ni le streaming.

Lire la réponse

Les images figurent dans candidates[].content.parts[].inlineData. Parcourez les éléments, ignorez thought: true, décodez data et choisissez l’extension selon mimeType. L’image n’est pas forcément le premier élément ni toujours au format PNG.

Guides associés

Autorisations

x-goog-api-key

string

header

requis

BetterToken API Key.

En-têtes

X-BetterToken-Max-Images

integer

défaut:1

Plafond d’images livrées et facturées, pas un nombre garanti. Valeur par défaut : 1.

Plage requise: 1 <= x <= 4

Paramètres de chemin

model

enum<string>

défaut:nano-banana-2.1

requis

Model ID BetterToken. Choisissez un des trois modèles Nano Banana.

Options disponibles:

nano-banana-pro,

nano-banana-2,

nano-banana-2.1

Corps

application/json

contents

object[]

requis

Historique. Conservez le content complet du modèle et thoughtSignature pour les retouches suivantes.

Minimum array length: 1

Show child attributes

generationConfig

object

Paramètres de génération.

Show child attributes

Réponse

Résultat. Vérifiez les images finales et finishReason.

candidates

object[]

Show child attributes

promptFeedback

object

usageMetadata

object

​Préparer les références

​Tester une requête

​Lire la réponse

​Guides associés

Autorisations

En-têtes

Paramètres de chemin

Corps

Réponse

Préparer les références

Tester une requête

Lire la réponse

Guides associés