Passer au contenu principal
POST
/
v3
/
gemini-3.1-flash-image-edit
Édition d’images Gemini 3.1 Flash
curl --request POST \
  --url https://api.highwayapi.ai/v3/gemini-3.1-flash-image-edit \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "size": "<string>",
  "google": {
    "web_search": true,
    "image_search": true
  },
  "prompt": "<string>",
  "image_urls": [
    {}
  ],
  "aspect_ratio": "<string>",
  "image_base64s": [
    {}
  ],
  "output_format": "<string>"
}
'
{
  "image_urls": [
    {}
  ],
  "grounding_metadata": {}
}
Utilisez le modèle Gemini 3.1 Flash pour modifier des images à l’aide de prompts en langage naturel. Prend en charge les images encodées en URL et en Base64 comme entrée, avec jusqu’à 14 images de référence.

​
En-têtes de requête

​
Content-Type
string
requis
Valeur d’énumération : application/json
​
Authorization
string
requis
Format d’authentification Bearer : Bearer {{API Key}}.

​
Corps de la requête

​
size
string
défaut:"1K"
Dimensions en pixels de l’image de sortie. 0.5K (environ 512px), 1K (environ 1024px), 2K (environ 2048px), 4K (environ 4096px). Par défaut : 1KValeurs possibles : 0.5K, 1K, 2K, 4K
​
google
object
Options de recherche Google
​
prompt
string
requis
Prompt textuel décrivant l’effet d’édition d’image souhaité
​
image_urls
array
Liste des URL des images d’entrée à modifier, jusqu’à 14 images de référence prises en chargeLongueur du tableau : 0 - 14
​
aspect_ratio
string
Format d’image de sortie. Prend en charge les formats standard ainsi que les nouveaux formats ultra-larges/ultra-longs (1:4, 4:1, 1:8, 8:1)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
​
image_base64s
array
Liste des images encodées en Base64 à modifier. Le nombre total de image_urls et image_base64s ne doit pas dépasser 14 imagesLongueur du tableau : 0 - 14
​
output_format
string
défaut:"image/png"
Type MIME de l’image de sortie. Formats pris en charge : image/png, image/jpeg. Par défaut : image/pngValeurs possibles : image/png, image/jpeg

​
Informations de réponse

​
image_urls
array
requis
Liste des URL des images modifiées
​
grounding_metadata
object
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 les paramètres ne garantit pas à 100 % le déclenchement d’un appel d’outil.