Принимает изображение и текстовое указание и возвращает изменённое изображение. Вызывается через POST /v1/images по
идентификатору gpt-image-2-image-to-image — тем же ключом, что остальные модели
каталога.
model запроса.Ключ создаётся в кабинете. Сюда он вводится на время запуска и никуда не сохраняется.
Запуск тратит кредиты: списывается фактический расход, а неуспешная задача не тарифицируется.
model — gpt-image-2-image-to-imageprompt — текст · от 1 до 20 000 символов · обязательноеinput_urls — список ссылок · от 1 до 16 ссылок на изображение · обязательноеaspect_ratio — значение из списка · auto · 1:1 · 3:2 · 2:3 · 4:3 · 3:4 · 5:4 · 4:5 · 16:9 · 9:16 · 2:1 · 1:2 · 3:1 · 1:3 · 21:9 · 9:21resolution — значение из списка · 1K · 2K · 4K{ "model": "gpt-image-2-image-to-image", "prompt": "Заменить фон на вечернюю городскую улицу, свет тёплый", "input_urls": [ "https://example.com/photo.jpg" ], "aspect_ratio": "auto", "resolution": "1K" }
Тело собирается из формы: заполните поля на вкладке Form — здесь видно, что уйдёт на шлюз.
Нажмите «Запустить» — изображение появится здесь
Ответ шлюза появится здесь после запуска.
Поля тела запроса. Значения проверяются до обращения к поставщику: поле не из списка
или значение вне перечисления возвращают ошибку 400 и кредитов не тратят.
| Поле | Тип | Обяз. | Допустимые значения |
|---|---|---|---|
| model | текст | обязательное | gpt-image-2-image-to-image |
| prompt | текст | обязательное | от 1 до 20 000 символов |
| input_urls | список ссылок | обязательное | от 1 до 16 ссылок на изображение |
| aspect_ratio | значение из списка | опц. | auto · 1:1 · 3:2 · 2:3 · 4:3 · 3:4 · 5:4 · 4:5 · 16:9 · 9:16 · 2:1 · 1:2 · 3:1 · 1:3 · 21:9 · 9:21 |
| resolution | значение из списка | опц. | 1K · 2K · 4K |
Поле, которого нет в таблице, шлюз не принимает: запрос с незнакомым именем отбивается с перечнем допустимых полей, чтобы опечатка не превратилась в оплаченную генерацию не того, что просили. Общие для всех моделей поля тела запроса и формат ответа описаны в разделе документации Images.
Цена считается за генерацию. Наша розница — официальная цена первоисточника минус 10%, счёт выставляется целыми кредитами по курсу 1 кредит = $0.005.
| Ступень | Наша цена, кредиты | Наша цена, USD | Официал, USD | Разница |
|---|---|---|---|---|
| 1 за генерацию | 39 | $0.195 | $0.219 | −11% |
| 2 за генерацию | 42 | $0.21 | $0.234 | −10,3% |
| 3 за генерацию | 74 | $0.37 | $0.413 | −10,4% |
Эти же ступени стоят отдельными строками в общем прайсе — там цена GPT Image 2 видна рядом с ценами остальных моделей каталога: строка в прайсе.
POST /v1/images — шлюз сам дожидается результата
у поставщика и отвечает ссылкой на изображение. В примере — обязательные поля модели и значения из её
перечислений.
curl https://api.gen202.com/v1/images \
-H "Authorization: Bearer sk-ваш-ключ" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2-image-to-image",
"prompt": "Заменить фон на вечернюю городскую улицу, свет тёплый",
"input_urls": [
"https://example.com/photo.jpg"
],
"aspect_ratio": "auto",
"resolution": "1K"
}'
import requests
r = requests.post(
"https://api.gen202.com/v1/images",
headers={"Authorization": "Bearer sk-ваш-ключ"},
json={
"model": "gpt-image-2-image-to-image",
"prompt": "Заменить фон на вечернюю городскую улицу, свет тёплый",
"input_urls": [
"https://example.com/photo.jpg"
],
"aspect_ratio": "auto",
"resolution": "1K"
},
).json()
print(r["data"][0]["url"], r["credits_charged"])
Ответ содержит data[0].url со ссылкой на изображение и
credits_charged со списанными кредитами. Эта же модель доступна задачами:
POST /api/v1/jobs/createTask с теми же полями внутри input.
Ключ для примера выпускается в кабинете; как он передаётся в заголовке, описано в разделе Аутентификация, а ограничение скорости запросов — в разделе Лимиты и эксплуатация.
Модели того же поставщика и модели с той же задачей в каталоге GEN202.
Отобранный каталог целиком:
Модели того же поставщика, модели с той же задачей и разделы, где о GPT Image 2 сказано отдельно.
Пока это единственная модель поставщика OpenAI на витрине.
Модель делает и то и другое, поэтому попадает в оба раздела каталога.
Ту же задачу у других поставщиков решают:
Другой режим этой же модели: генерация из текста. Идентификатор в поле model там другой, и поля запроса свои.
Строка этой модели в общем прайсе — все её ступени рядом с ценами остальных моделей.
Быстрый старт — Базовый адрес шлюза и первый вызов через один ключ.
Аутентификация — Как передать ключ в заголовке запроса.
Images — Эндпоинт /v1/images, через который вызывается эта модель.
Лимиты и эксплуатация — Ограничение скорости запросов и логи вызовов в кабинете.