Примечания по использованию изображений (лучшие практики)

Генерация изображений — это синхронный длительный запрос (обычно 10–60 секунд), и привычки вызова отличаются от интерфейса диалога. Перед масштабированием обязательно внимательно прочитайте эту страницу.

Таймауты и повторные попытки

Установите таймаут клиента ≥120 секунд; значение по умолчанию 30 секунд в HTTP-библиотеках прерывает соединение до завершения генерации;
Для оборванных запросов upstream уже мог находиться в процессе тарификации — при ошибке предварительно удержанная сумма будет автоматически возвращена, но не выполняйте немедленные частые повторные попытки, рекомендуется экспоненциальный backoff (5s → 15s → 45s);
429 означает срабатывание ограничения частоты; способ обработки см. вОграничение частоты и 429。

Выбор модели и формата

Формат/разрешение задаются через суффикс имени модели (-portrait, -landscape, -2k, -4k и т. д.), не полагайтесь на параметр size, полные правила см. вМодели генерации изображений и видео;
В сценариях массовой генерации сначала выбирайте уровень -fast, а после проверки промпта переходите на стандартный уровень для финальной доработки;
Модели 4K дороже и генерируются медленнее, используйте их только на этапе финального результата.

Обработка результата

URL полученного изображения имеет ограниченный срок действия, сразу после получения сохраните его в собственное объектное хранилище, не используйте hotlink;
При возврате base64 учитывайте, что тело ответа может быть большим, поэтому верхний предел body у обратного прокси и шлюза нужно увеличить;
Оплата по факту использования: за успешный запрос списывается один раз, за неудачный запрос (ошибка upstream/таймаут) списание не производится.

Контроль затрат

Сначала используйте небольшие партии для настройки шаблона промпта, а после стабилизации увеличивайте объём;
Для бизнес-задач с изображениями создайте отдельный API-токен и задайте верхний лимит бюджета, чтобы программная ошибка не исчерпала весь бюджет;
Списание по каждому запросу можно сверить в консоли в разделе “журнал”, либо использовать для сверкиAPI查询日志。