Pular para o conteúdo principal
POST
/
v3
/
gemini-3.1-flash-image-edit
Edição de imagens com 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": {}
}
Edite imagens usando o modelo Gemini 3.1 Flash com prompts em linguagem natural. Compatível com imagens em URL e codificadas em Base64 como entrada, com suporte para até 14 imagens de referência.

​
Cabeçalhos da requisição

​
Content-Type
string
obrigatório
Valores enumerados: application/json
​
Authorization
string
obrigatório
Formato de autenticação Bearer: Bearer {{API Key}}.

​
Corpo da requisição

​
size
string
padrão:"1K"
Dimensão em pixels da imagem de saída. 0.5K (aprox. 512px), 1K (aprox. 1024px), 2K (aprox. 2048px), 4K (aprox. 4096px). O padrão é 1KValores opcionais: 0.5K, 1K, 2K, 4K
​
google
object
Opções de pesquisa do Google
​
prompt
string
obrigatório
Prompt de texto que descreve o efeito desejado de edição da imagem
​
image_urls
array
Lista de URLs das imagens de entrada a serem editadas, com suporte para até 14 imagens de referênciaComprimento do array: 0 - 14
​
aspect_ratio
string
Proporção da imagem de saída. Compatível com proporções padrão e novas proporções ultra-largas/ultra-altas (1:4, 4:1, 1:8, 8:1)Valores opcionais: 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 imagens codificadas em Base64 a serem editadas. A soma de image_urls e image_base64s não deve exceder 14 imagensComprimento do array: 0 - 14
​
output_format
string
padrão:"image/png"
Tipo MIME da imagem de saída. Formatos compatíveis: image/png, image/jpeg. O padrão é image/pngValores opcionais: image/png, image/jpeg

​
Informações de resposta

​
image_urls
array
obrigatório
Lista de URLs das imagens editadas
​
grounding_metadata
object
Metadados de grounding do modelo. Retornados quando ferramentas do lado do servidor do Google (por exemplo, pesquisa) são chamadas. Observação: a chamada de ferramentas depende do Google. Ativar ferramentas por parâmetro não garante 100% que a chamada de ferramenta será acionada.