Правка изображений
Изображение по изображению через API Cheapest Imagen. Отправьте опорные изображения на /v1/images/edits файлами или ссылками и опишите изменение.
Отправьте промпт и одно или несколько опорных изображений на POST /v1/images/edits. Опорные изображения принимает каждая модель, а правка стоит столько же кредитов, сколько новое изображение.
Загрузка файлов
Отправьте запрос как форму. Повторяйте image[] для каждого опорного изображения.
curl https://api.cheapestimagen.com/v1/images/edits \
-H "Authorization: Bearer $YOUR_KEY" \
-F model=nano-banana-2.1 \
-F prompt="put the product on a marble table, soft daylight" \
-F "image[]=@product-front.png" \
-F "image[]=@product-side.png" \
-F size=2048x2048 \
-F response_format=urlС SDK OpenAI:
from openai import OpenAI
client = OpenAI(base_url="https://api.cheapestimagen.com/v1", api_key="YOUR_KEY")
result = client.images.edit(
model="gpt-image-2.6",
image=[open("portrait.png", "rb")],
prompt="change the jacket to dark green, keep the face and the background",
response_format="url",
)
print(result.data[0].url)Ссылки вместо файлов
Отправьте JSON с массивом images. У каждого элемента есть image_url: ссылка https: или base64-URL data:.
curl https://api.cheapestimagen.com/v1/images/edits \
-H "Authorization: Bearer $YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "nano-banana-pro",
"prompt": "turn this sketch into a watercolour illustration",
"images": [{ "image_url": "https://example.com/sketch.png" }]
}'file_id не поддерживается; передавайте image_url.
Лимиты
| Опорных изображений в запросе | от 1 до 16 |
| Размер одного изображения | до 20 МБ |
| Размер всего запроса | до 50 МБ |
| Типы файлов | PNG, JPEG, WebP |
Запрос сверх этих лимитов возвращает 413.
Параметры
Все параметры создания изображения по тексту работают и в правках: n, size, quality, output_format, response_format. Ещё один параметр только для правок:
| Поле | Что делает | Значения |
|---|---|---|
input_fidelity | Насколько точно результат сохраняет детали опорных изображений | low (по умолчанию), high. Работает в GPT Image 2.5 и 2.6 и их версиях flare и sunburst; другие модели возвращают 400 |
Что не поддерживается
- Маски. Перерисовать только одну область нельзя. Опишите в промпте, что должно остаться прежним.
- Прозрачный фон.
background: transparentвозвращает400на любой модели.
Советы
- Отправьте несколько ракурсов объекта, если он должен остаться прежним.
- Укажите, что менять нельзя: «оставь этикетку без изменений», «то же лицо и причёска».
- Для вывода в 2K и 4K используйте Nano Banana,
gpt-image-2-adobeили версию flare или sunburst. См. Соотношения и размеры.
Модели
Все ID моделей API Cheapest Imagen с официальной моделью OpenAI или Google, которая за ними стоит, создаваемыми разрешениями и ценой в кредитах за изображение.
Соотношения и размеры
Размеры изображений, которые можно передать в поле size API Cheapest Imagen: до 19 соотношений сторон в 1K, 2K и 4K, а также свои размеры.