Перейти к содержимому
Cheapest Imagen
Руководства

Правка изображений

Изображение по изображению через 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. См. Соотношения и размеры.

На этой странице