Перейти к основному содержанию
POST
/
v3
/
gemini-3.1-flash-image-edit
Редактирование изображений 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": {}
}
Редактируйте изображения с помощью модели Gemini 3.1 Flash, используя подсказки на естественном языке. В качестве входных данных поддерживаются изображения по URL и изображения в кодировке Base64; можно передать до 14 референсных изображений.

Заголовки запроса

Content-Type
string
обязательно
Перечисляемое значение: application/json
Authorization
string
обязательно
Формат аутентификации Bearer: Bearer {{API 密钥}}.

Тело запроса

size
string
по умолчанию:"1K"
Размер выходного изображения в пикселях. 0.5K (около 512px), 1K (около 1024px), 2K (около 2048px), 4K (около 4096px). По умолчанию — 1KВозможные значения: 0.5K, 1K, 2K, 4K
google
object
Параметры поиска Google
prompt
string
обязательно
Текстовая подсказка, описывающая желаемый эффект редактирования изображения
image_urls
array
Список URL входных изображений для редактирования; поддерживается до 14 референсных изображенийДлина массива: 0 - 14
aspect_ratio
string
Соотношение сторон выходного изображения. Поддерживаются стандартные соотношения, а также новые сверхширокие/сверхдлинные соотношения (1:4, 4:1, 1:8, 8:1)Возможные значения: 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
Список изображений в кодировке Base64 для редактирования. Общее количество элементов в image_urls и image_base64s не должно превышать 14Длина массива: 0 - 14
output_format
string
по умолчанию:"image/png"
MIME-тип выходного изображения. Поддерживаемые форматы: image/png, image/jpeg. По умолчанию — image/pngВозможные значения: image/png, image/jpeg

Информация об ответе

image_urls
array
обязательно
Список URL отредактированных изображений
grounding_metadata
object
Метаданные grounding модели. Возвращаются, когда вызываются серверные инструменты Google (например, поиск). Примечание: вызов инструментов зависит от Google. Включение инструментов в параметрах не гарантирует их вызов в 100% случаев.