GPT Image
Генерация и редактирование картинок через openai/gpt-image-2.
Скачать инструкцию для агента .mdGPT Image использует маршруты картинок, совместимые с OpenAI. Новые картинки отправляйте в /v1/images/generations. Редактирование отправляйте в /v1/images/edits: промпт описывает правку, исходные картинки передаются в images. Результат читайте из data[0].b64_json или data[0].url.
Запрос
GPT Image request
curl https://api.aigate.shop/v1/images/generations \ -H "Authorization: Bearer sk-your-api-key" \ -H "Content-Type: application/json" \ -d '{ "model": "openai/gpt-image-2", "prompt": "A clean studio product photo of a matte black smart speaker on glass, softbox lighting", "quality": "medium", "size": "1024x1024", "n": 1 }'Ответ
Image response
{ "created": 1779703910, "data": [ { "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..." } ], "usage": { "input_tokens": 712, "output_tokens": 1372, "total_tokens": 2084 }}Редактирование картинки
Используйте /v1/images/edits, когда модель должна изменить существующую картинку. Инструкцию пишите в prompt, а одну или несколько исходных картинок передавайте в images. Для JSON-запроса используйте image_url; multipart с файлом тоже возможен, если это поддерживает выбранная модель.
GPT Image edit request
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" } ] }'Ответ редактирования
{ "created": 1779703910, "data": [ { "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..." } ], "usage": { "input_tokens": 712, "output_tokens": 1372, "total_tokens": 2084 }}Поля запроса
| Поле | Обяз. | Что значит |
|---|---|---|
| model | да | openai/gpt-image-2 или точный GPT Image id из каталога. |
| prompt | да | Текстовое описание картинки. |
| images | только edits | Массив исходных картинок. Для JSON-запросов указывайте image_url. |
| quality | нет | low, medium, high или значение по умолчанию, если поле не передано. |
| size | нет | WIDTHxHEIGHT, например 1024x1024 или 2048x880, если поддерживается. |
| resolution | нет | Подсказка 1k, 2k или 4k, если модель поддерживает. |
| n | нет | Количество картинок. |
| background/output_format | нет | Передается модели, если она поддерживает эти поля. |
Как сохранить base64
ts
import { writeFileSync } from "node:fs";const image = response.data[0];if (image.b64_json) { writeFileSync("gpt-image.png", Buffer.from(image.b64_json, "base64"));} else if (image.url) { console.log(image.url);}Промптинг
- Начинайте с главного объекта, затем добавляйте окружение, композицию, свет, стиль и ограничения.
- Для товарных изображений указывайте материал, ракурс, фон и нужен ли текст или логотип.
- Для прозрачного фона просите это явно и используйте модель и формат ответа, которые это поддерживают.