Skip to main content
POST
Playground документации не поддерживает загрузку файлов: используйте для тестирования примеры кода на cURL, Python или JavaScript ниже.
Временное хранение: Загруженные изображения хранятся только 72 часа, после чего URL изображения станет недействительным. Используйте изображение в течение этого срока или своевременно сохраните его в собственном хранилище.
Важное изменение: Для повышения производительности и контроля затрат мы больше не поддерживаем передачу данных изображений в формате base64 напрямую в API генерации. Используйте этот API, чтобы загрузить изображение, получить URL и затем вызвать API генерации.

Зачем сначала загружать изображения?

  1. Оптимизация производительности — кодирование base64 увеличивает объём данных на 33%; предварительная загрузка значительно уменьшает размер тела запроса
  2. Повторное использование изображений — загрузите один раз и используйте URL многократно без повторных передач

Рабочий процесс

Авторизация

string
обязательно
Все API требуют аутентификации с помощью Bearer TokenПолучите API-ключ:Перейдите на страницу управления API-ключами, чтобы получить API-ключДобавьте его в заголовки запроса:

Тело запроса

file
обязательно
Файл изображенияПоддерживаемые форматы: JPEG (.jpg, .jpeg), PNG (.png), WebP (.webp), GIF (.gif)Максимальный размер файла: 20 МБ

Ответ

string
Публичный URL доступа к изображению, можно использовать напрямую в API генерации (действителен 72 часа)
string
Исходное имя файла
string
Определённый MIME-тип, например image/jpeg
integer
Размер файла в байтах
integer
Время загрузки в формате Unix-метки (в секундах)

Полный пример: рабочий процесс «изображение в изображение»

Python