Справочник API/Генерация изображений
API генерации изображений
Создавайте и редактируйте изображения через /v1/images/generations и /v1/images/edits. Поддерживаются произвольные размеры и асинхронные задачи; оплата зависит от фактического размера результата.
На этой страницеexpand_more
Быстрые примерыlink
/images/generations поддерживает произвольные соотношения сторон. Платформа проверяет запрос и резервирует средства по запрошенному size, а после успешной генерации списывает оплату по фактическим размерам полученного изображения.
curl https://api.wokey.ai/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.5",
"prompt": "A quiet lake at sunrise",
"size": "1536x1024"
}'Возвращает data[0].b64_json. Для редактирования изображения используется файловое поле image; в асинхронном режиме возвращается ID задачи.
Асинхронный режимlink
Prefer: respond-async· ID задачи → опрос статуса → скачивание изображенияПараметры запросаlink
| Параметр | Обязательный | Описание |
|---|---|---|
| model | Да | Сейчас поддерживается gpt-image-2.5; устаревший алиас gpt-image-2 тоже принимается. |
| prompt | Да | Непустой промпт для изображения. |
| size | Нет | WIDTHxHEIGHT, включая неквадратные соотношения сторон; каждая сторона — от 128 до 4096 px. Если параметр не указан или равен auto, используется 1024x1024. |
| n | Нет | Сейчас поддерживается только 1. Если параметр не указан, используется 1. |
| stream | Нет | Укажите true, чтобы получать ответ по официальному протоколу потоковой генерации изображений OpenAI через SSE: промежуточные превью приходят событиями image_generation.partial_image, а итоговое изображение — событием image_generation.completed. Оплата такая же, как без потоковой передачи; превью бесплатны. |
| partial_images | Нет | Количество промежуточных превью при потоковой передаче, целое число 0-3 (по умолчанию 0 — только итоговое событие). |
Параметр ответа: data[0].b64_json содержит сгенерированное изображение в base64.
Уровни и оплатаlink
Уровни определяются по длинной стороне изображения. Запрошенный size определяет предварительный резерв; итоговое списание — по длинной стороне фактически полученного изображения.
| Уровень | Длинная сторона результата | Резерв по запрошенному size | Цена |
|---|---|---|---|
| 1K | <= 1280 px | Запрошенная длинная сторона <= 1280 px | $0.01 / изобр. |
| 2K | 1281-2048 px | Запрошенная длинная сторона 1281-2048 px | $0.01 / изобр. |
| 4K | 2049-4096 px | Запрошенная длинная сторона 2049-4096 px | $0.01 / изобр. |
Частые вопросыlink
- Что за ключ «Studio 网页生图» в списке ключей? Можно ли его удалить?
- После того как вы воспользуетесь Studio: изображения, платформа автоматически создаёт для вас служебный API-ключ с названием «Studio 网页生图» (у ранних пользователей он может называться «网页生图»). Каждая генерация в Studio оплачивается через него по тем же правилам учёта и ограничения частоты запросов, что и вызовы API, поэтому в истории вызовов эти записи привязаны к этому ключу. Сам секрет ключа никогда не передаётся в браузер. Удалять или приостанавливать его безопасно — при следующей генерации в Studio он будет создан заново.
- Как оплачивается Studio: изображения?
- Так же, как через API: за каждое изображение, по уровню фактического размера, со списанием с баланса аккаунта. Расходы отображаются в сводке использования и истории вызовов; отдельных тарифов нет.
- Где хранятся изображения из Studio?
- Только в вашем текущем браузере. Платформа не хранит сгенерированные изображения, поэтому при смене браузера, устройства или очистке данных сайта история теряется — скачивайте всё, что хотите сохранить.