Генерация изображений

Маршрут доступен только если /v1/models возвращает модель с endpoint images.generations. Если таких моделей нет, генерация изображений сейчас отключена.

curl https://go2llm.tech/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: project-20260831-image-001" \
  -H "content-type: application/json" \
  -d '{
    "model": "MODEL_ID_ИЗ_КАТАЛОГА",
    "prompt": "Минималистичная схема API-шлюза",
    "n": 1,
    "size": "1024x1024",
    "quality": "standard",
    "response_format": "url"
  }'

Допустимые size, quality и максимальное n находятся в поле image каталога. Idempotency-Key обязателен, должен содержать 8–128 печатных ASCII-символов и оставаться тем же только при повторе идентичного запроса.

Успешный ответ содержит data[].url, количество результатов в usage.images и итоговое списание в USD в usage.cost_usd. Поддерживается только response_format: "url"; максимальный размер JSON-тела — 20 MiB.

Списание резервируется до upstream-запроса и фиксируется только после успешного ответа. Повтор с тем же Idempotency-Key и тем же телом возвращает сохранённый результат без повторного списания; тот же ключ с другим телом вернёт 409.

Редактирование по исходной картинке (img2img)

POST /v1/images/edits принимает от одной до четырёх исходных картинок и промпт. Маршрут работает для моделей, у которых в endpoints есть images.edits; остальные модели ответят 404 model_not_found.

curl https://go2llm.tech/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: project-20261007-edit-001" \
  -F model=MODEL_ID_ИЗ_КАТАЛОГА \
  -F "prompt=Поставь товар на белый фон" \
  -F size=1024x1024 \
  -F image=@photo.png

Несколько исходников передаются как image[], до четырёх. Принимаются PNG, JPEG и WebP; формат проверяется по содержимому файла, а не по имени. mask не поддерживается: что поменять, опишите в prompt. Можно прислать и JSON, картинки тогда идут base64 в images: [{"image_url": "data:image/png;base64,..."}]. Ссылки на картинки с чужих сайтов не принимаются, загрузите файл.

Цена за результат та же, что у генерации, остальные правила тоже: Idempotency-Key, варианты из поля image, тело до 20 MiB. Ссылка вида go2llm.tech/media/images/… живёт сутки, результат стоит скачать.