Saltar al contenido principal
POST
/
v3
/
gemini-3.1-flash-image-edit
Edición de imágenes con 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": {}
}
Edita imágenes mediante indicaciones en lenguaje natural con el modelo Gemini 3.1 Flash. Admite imágenes codificadas como URL y Base64 como entrada, y permite enviar hasta 14 imágenes de referencia.

​
Encabezados de la solicitud

​
Content-Type
string
requerido
Valores enumerados: application/json
​
Authorization
string
requerido
Formato de autenticación Bearer: Bearer {{API Key}}.

​
Cuerpo de la solicitud

​
size
string
predeterminado:"1K"
Dimensiones en píxeles de la imagen de salida. 0.5K (aprox. 512px), 1K (aprox. 1024px), 2K (aprox. 2048px), 4K (aprox. 4096px). El valor predeterminado es 1KValores opcionales: 0.5K, 1K, 2K, 4K
​
google
object
Opciones de búsqueda de Google
​
prompt
string
requerido
Indicación de texto que describe el efecto de edición de imagen deseado
​
image_urls
array
Lista de URL de imágenes de entrada utilizadas para la edición. Admite hasta 14 imágenes de referenciaLongitud del array: 0 - 14
​
aspect_ratio
string
Relación de aspecto de la imagen de salida. Admite proporciones estándar y nuevas proporciones ultraanchas/ultralargas (1:4, 4:1, 1:8, 8:1)Valores opcionales: 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
Lista de imágenes codificadas en Base64 utilizadas para la edición. La cantidad total de image_urls e image_base64s no debe superar 14Longitud del array: 0 - 14
​
output_format
string
predeterminado:"image/png"
Tipo MIME de la imagen de salida. Formatos admitidos: image/png, image/jpeg. El valor predeterminado es image/pngValores opcionales: image/png, image/jpeg

​
Información de la respuesta

​
image_urls
array
requerido
Lista de URL de las imágenes editadas
​
grounding_metadata
object
Metadatos de grounding del modelo. Se devuelven cuando se invocan herramientas del lado del servidor de Google (por ejemplo, búsqueda). Nota: la invocación de herramientas depende de Google. Habilitar herramientas mediante parámetros no garantiza al 100 % que se active una invocación de herramientas.