Генерация изображений
POST /v1/images/generations создаёт задание на генерацию изображения и сразу возвращает ответ. Для получения результата опрашивайте общую конечную точку заданий.
curl -sS -X POST https://api.dreamutopia.net/v1/images/generations \
-H "Authorization: Bearer $DREAMUTOPIA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "pro",
"prompt": "a red fox in fresh snow, cinematic lighting",
"resolution": "2k",
"aspect_ratio": "16:9"
}'{ "id": "3f2b…", "type": "image", "status": "queued", "created_at": "2026-10-24T12:00:00Z" }Поля
| Field | Values |
|---|---|
| model | lite, pro |
| prompt | Обязательно, не пусто, до 8 000 символов |
| resolution | 2k, 4k; lite принимает только 2k |
| aspect_ratio | 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, adaptive |
| reference_images | Загрузите ids или URL-адреса DreamUtopia; от 0 до 3 для lite, от 0 до 14 для pro |
model
- Values
lite,pro
prompt
- Values
- Обязательно, не пусто, до 8 000 символов
resolution
- Values
2k,4k;liteпринимает только2k
aspect_ratio
- Values
1:1,4:3,3:4,16:9,9:16,3:2,2:3,adaptive
reference_images
- Values
- Загрузите ids или URL-адреса DreamUtopia; от 0 до 3 для
lite, от 0 до 14 дляpro
adaptive требует как минимум одно референсное изображение. Опустите reference_images для генерации изображения по тексту. resolution по умолчанию равно 2k, а aspect_ratio — 1:1, поэтому model + prompt — это допустимый запрос.
Смешивание референсов
Одна ссылка — это преобразование изображения в изображение; две или более — это смешивание нескольких ссылок. Сначала загрузите каждый файл и передайте идентификаторы по порядку.
-d '{
"model": "pro",
"prompt": "combine the two products on one studio table",
"resolution": "2k",
"aspect_ratio": "adaptive",
"reference_images": ["<upload_id>", "<upload_id>"]
}'Стоимость
Начисления за изображения фиксированы для каждого тарифа. Актуальные значения доступны в GET /v1/models в разделе image[].credits. Кредиты списываются при создании задачи и возвращаются в случае её сбоя.