Документация API

Редактирование картинок

Как менять готовые картинки через GPT Image и модели Gemini для картинок.

Редактирование картинок зависит от типа модели. GPT Image принимает правку через /v1/images/edits. Модели Gemini для картинок работают как чат-модели: исходная картинка передается в сообщении, а новая картинка возвращается в ответе чата.

GPT Image

Для GPT Image отправляйте POST /v1/images/edits. В prompt пишите, что нужно изменить, а в images передавайте одну или несколько исходных картинок. В JSON используйте image_url; если модель поддерживает загрузку файла, можно отправлять multipart/form-data.

Запрос GPT Image

curl https://api.aigate.shop/v1/images/edits \  -H "Authorization: Bearer sk-your-api-key" \  -H "Content-Type: application/json" \  -d '{    "model": "openai/gpt-image-2",    "prompt": "Add a small orange cat sitting on the table. Keep the original lighting and style.",    "images": [      {        "image_url": "https://picsum.photos/seed/aigate-edit-test/800/600"      }    ]  }'

Ответ GPT Image

{  "created": 1779703910,  "data": [    {      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."    }  ],  "usage": {    "input_tokens": 712,    "output_tokens": 1372,    "total_tokens": 2084  }}

Где результатОбычно готовая картинка лежит в data[0].b64_json. Если провайдер вернул ссылку, она будет в data[0].url.

Gemini Images

Модели Gemini для картинок не отправляйте в /v1/images/edits. Это текстовые чат-модели, которые умеют возвращать картинки, поэтому для редактирования используйте /v1/chat/completions.

В messages.content передайте два элемента: текст с инструкцией и image_url с исходной картинкой. Добавьте modalities: ["image", "text"]. Ответ приходит в choices[0].message.images[0].image_url.url.

Запрос Gemini

curl https://api.aigate.shop/v1/chat/completions \  -H "Authorization: Bearer sk-your-api-key" \  -H "Content-Type: application/json" \  -d '{    "model": "google/gemini-3.1-flash-image-preview",    "messages": [      {        "role": "user",        "content": [          {            "type": "text",            "text": "Edit this image: add a small orange cat sitting on the table. Keep the original lighting and style. Return the edited image."          },          {            "type": "image_url",            "image_url": {              "url": "https://picsum.photos/seed/aigate-edit-test/800/600"            }          }        ]      }    ],    "modalities": ["image", "text"]  }'

Ответ Gemini

{  "id": "gate-1779703910",  "object": "chat.completion",  "created": 1779703910,  "model": "google/gemini-3.1-flash-image-preview",  "choices": [    {      "index": 0,      "message": {        "role": "assistant",        "content": null,        "images": [          {            "type": "image_url",            "image_url": {              "url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."            }          }        ]      },      "finish_reason": "stop"    }  ]}

Ответ в base64Gemini обычно возвращает data URL вида data:image/png;base64,... . Для сохранения файла возьмите часть после запятой и декодируйте base64. content может быть null, это нормально для ответа с картинкой.

Коротко

Модель	Куда слать	Где читать картинку
openai/gpt-image-2	POST /v1/images/edits	data[0].b64_json
Gemini image models	POST /v1/chat/completions	choices[0].message.images[0].image_url.url

НазадОбзор картинокДальшеGPT Image