Редактирование изображения компании

Используйте POST /v1/images/edits только с проверенным маршрутом image.edit. Передавайте multipart-поля model, prompt, необязательные поддерживаемые скалярные параметры и image либо повторяющиеся части image[]. Не смешивайте эти две формы поля изображения. Одна mask принимается только при разрешении маршрута; обязательность, MIME, размер, совпадение размеров и требования к альфа-каналу задаются проверенным контрактом.

Сохраняйте стабильный Idempotency-Key этой операции. Шлюз декодирует фактические байты изображения, не считает имя файла и MIME клиента доказательством формата и проверяет пределы числа и размера изображений маршрута. Рабочие форматы — PNG, JPEG и статический WebP; анимированные входы отклоняются. Стандартные пределы — 16 MiB на изображение, 32 MiB суммарно и 16 миллионов пикселей на изображение; политика маршрута и настройки запроса могут уменьшать их.

Для фоновой обработки добавьте multipart-поле model_gate со значением {"async":true}. Учётные данные компании передаются в заголовке Authorization, а не в multipart-полях. Исходные и полученные изображения закрыты в рамках владельца/principal/ключа/группы операции. После обрыва клиентского соединения используйте ID операции, а не повторный POST редактирования.

Порядок опроса, сроки хранения и повторы только скачивания описаны в обработке операций компании. Баланс компании рассчитывается существующим финансовым механизмом, а не отдельным кошельком изображений.

Вкладка Images в Playground формирует настоящий multipart-запрос редактирования, не раскрывая постоянные секреты API. Необязательный model_gate.quote_sha256 связывает запуск с предыдущим бесплатным расчётом цены; метаданные входов для расчёта не заменяют проверку самих файлов.

В деталях и истории операций компании предварительные суммы остаются явно помеченными до записи фактических данных для расчёта. Вычисленная стоимость сама по себе не подтверждает списание компании. Пустой список файлов во время обработки не означает истёкший срок скачивания. Отдельное представление агрегированного usage и подписи цен описаны в полях результата изображения.

Ошибки запросов изображений

Ошибки содержат стабильный error.code, понятный error.message, error.type и, где применимо, error.param. Сохраните X-Request-ID из ответа для поддержки; не отправляйте API-ключ. Неизвестная каноническая модель или псевдоним возвращают 400 model_not_found, а не ошибку доступности каталога.

Ограничения нескольких маршрутов не объединяются в выдуманные допустимые комбинации. Не повторяйте платный POST автоматически после тайм-аута или неоднозначной ошибки. Проверьте статус операции и сохраните исходный ключ идемпотентности. Подробные внутренние ошибки конфигурации и учётных данных клиенту не возвращаются.