🎉 Бесплатные генерации при первой покупке каждого пакета — до 20 Lite-видео + 20 Lite-изображений + 10 Medium-видео + 10 Pro-изображений + 2 Pro-видео.

Начать работу
DreamUtopia
ru

Cursor теперь может генерировать изображения

Cursor уже редактирует ваш код. С DreamUtopia REST API та же сессия может создать главное изображение, изменить стиль продуктового снимка или превратить статичное изображение в восьмисекундное видео. Вставьте один файл навыка, спросите на простом английском, и агент сам выполнит загрузку, запрос и опрос статуса.

Начните с готового примера

Это промпты, использованные для примеров на этой странице. Откройте генератор, выберите пример и меняйте по одной детали за раз.

Перерисуй этот штормовой берег в сумерках. Сохрани маяк и чёрные скалы, пропусти луч через морской туман и сделай грозовые облака гуще.

Пример промпта 01

Перерисуй этот штормовой берег в сумерках. Сохрани маяк и чёрные скалы, пропусти луч через морской туман и сделай грозовые облака гуще.

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

Пример промпта 02

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

Напиши это альпийское озеро свободной акварелью. Сохрани вершины и отражение, смягчи хвойные деревья и сделай рассветный свет теплее.

Пример промпта 03

Напиши это альпийское озеро свободной акварелью. Сохрани вершины и отражение, смягчи хвойные деревья и сделай рассветный свет теплее.

Генерация изображений в Cursor, не покидая редактор

Генерация изображений в Cursor становится обычной частью сессии программирования, когда агент может напрямую вызывать медиа-API. Агенты для программирования хорошо умеют запускать команды, читать ответы и разумно повторять попытки — именно это и нужно медиа-API. Вместо того чтобы покидать редактор и открывать веб-приложение, вы можете попросить Cursor создать изображение-заголовок в формате 16:9 и получить URL результата в том же разговоре. Именно поэтому мы создали DreamUtopia API как обычный REST. Здесь нет MCP-сервера для настройки и плагина для установки. Файл навыка сообщает агенту базовый URL, заголовок аутентификации, multipart-загрузку, две конечные точки создания, цикл опроса и правила обработки ошибок. Один вставленный навык и одна переменная окружения — это вся настройка. Тот же ключ также работает из ваших собственных скриптов, а значит, агент и ваш сборочный конвейер используют одну интеграцию и один баланс кредитов. Это важно, когда задача по дизайну начинается в чате и заканчивается в скрипте развёртывания: форма запроса не меняется между ними. Рабочий процесс также соответствует тому, как агенты для программирования уже работают: запрос — это обычная команда оболочки, сбой — это обычный HTTP-статус, а длительная задача — это обычный id для опроса. Это значит, что Cursor может объяснить сбой тем же голосом, которым он пользуется для падающего теста, и может хранить сгенерированный ресурс рядом с кодом, который на него ссылается. Для репозитория с интенсивным дизайном разница практическая, а не косметическая: человек, пишущий компонент, — это также человек, который может создать нужное для него изображение, без переключения инструментов и без потери контекста изменения. Cursor может выполнить запрос, прочитать ответ JSON и объяснить сбой, не покидая файл, который вы редактируете. В этом вся суть цикла обратной связи: агент уже знает, как запустить команду и интерпретировать результат, поэтому генерация медиа становится ещё одним инструментом, который он может использовать.

Что вы получаете

Один навык копирования и вставки

Вставьте блок навыка ниже в чат Cursor. Агент следует рецепту на протяжении остальной части разговора без дополнительных подсказок. Текст достаточно короткий, чтобы прочитать его за один раз, и достаточно конкретный, чтобы агент не импровизировал с именами полей. В нём указаны точные значения, которые принимает каждое поле, поэтому некорректный запрос исправляется до того, как достигнет API. В ваш репозиторий ничего не записывается и ничего не устанавливается.

Локальные файлы обработаны

Агент загружает фотографию из вашего проекта multipart-запросом, затем передаёт возвращённый id в генерацию. Ограничение — 30 МБ для JPEG, PNG и WebP. Файлу, который находится в репозитории, никогда не нужен предварительный публичный URL.

Изображения и видео, один ключ

Текст-в-изображение, изображение-в-изображение, текст-в-видео, изображение-в-видео и переходы от первого/последнего кадра используют один и тот же ключ и один и тот же баланс кредитов. Вам не нужно управлять отдельными аккаунтами для статичных изображений и видео, и навык может связать одно готовое изображение со следующим запросом на видео.

Работа, которая переживает чат

Каждая генерация выполняется на наших серверах. Если сессия завершается, агент может получить список недавних задач по id и позже забрать результат. Подписанная ссылка на результат остаётся действительной семь дней — этого достаточно, чтобы скачать его или скопировать в артефакт сборки.

Запросы на простом английском

Запросите квадратный снимок продукта или вертикальный клип для соцсетей. Навык сопоставляет ваши слова с моделью, разрешением, длительностью и соотношением сторон, а затем проверяет актуальную матрицу цен, прежде чем потратить средства. Вы по-прежнему можете указать точные настройки, когда этого требует задача. Агент сообщает вам выбранные настройки, что упрощает диагностику неожиданного результата.

Один прайс-лист

API и веб-приложение списывают одинаковые кредиты. GET /v1/models возвращает актуальную матрицу разрешений, длительностей и кредитов, так что агент может сравнить пятисекундный клип с десятисекундным, прежде чем что-либо создавать.

Как это работает

1

Создайте и экспортируйте ключ

Откройте Profile, затем API keys и создайте именованный ключ. Экспортируйте его как DREAMUTOPIA_API_KEY в оболочке, из которой запускается Cursor. Ключи доступны платным аккаунтам, показываются один раз и могут быть отозваны без затрагивания ваших других интеграций.

2

Вставьте навык

Скопируйте блок ниже и вставьте его в чат Cursor. Тогда агент узнает конечные точки, имена полей и правила опроса для этого разговора. Навык также указывает, чего не делать: не повторять отклонённую задачу и не вставлять ключ в разговор. Повторите вставку в новом сеансе; в ваш репозиторий ничего не добавляется.

3

Просите то, что вам нужно

Сформулируйте обычный запрос: сгенерируй изображение 2K с рыжей лисой на снегу или преврати ./photo.png в клип 720p с медленным наездом. Агент сам выбирает настройки, может сначала проверить /v1/models и берёт на себя загрузку, если источник — локальный файл. Если запрос неоднозначен, он задаёт один короткий вопрос, а не угадывает длительность или соотношение сторон.

4

Опрос и использование результата

Агент опрашивает GET /v1/generations/{id} до тех пор, пока задание не завершится успешно, затем возвращает подписанный URL результата. Он делает паузы между опросами и останавливается при ошибке редактора, вместо того чтобы повторять попытку при отказе по политике контента или исчерпанном балансе кредитов. Итоговый ответ содержит как идентификатор задания, так и ссылку, чтобы результат можно было найти снова после того, как разговор будет удалён.

Вставьте навык DreamUtopia в Cursor

Скопируйте навык ниже и вставьте его в чат Cursor. После этого агент будет знать поверхность API, правила обработки ошибок и когда не следует повторять попытки, на протяжении всего остального разговора.

Paste into Cursor
Download
> Paste this into the Cursor chat. It teaches the agent the DreamUtopia API for the
> rest of the conversation. Keep the `DREAMUTOPIA_API_KEY` in your shell environment,
> not in the pasted text.

# DreamUtopia media generation

Use this skill when the user asks you to generate an image or a video with DreamUtopia.

## Prerequisites

- **API access requires a paid account.** Keys cannot be minted by a free account.
- The user sets their key in the environment:

  ```sh
  export DREAMUTOPIA_API_KEY="du_live_..."
  ```

  If `DREAMUTOPIA_API_KEY` is unset, **stop and ask the user to set it**. Never write the key
  into a project file, a commit, or a message.
- Base URL: `https://api.dreamutopia.net/v1`
- Every request sends `Authorization: Bearer $DREAMUTOPIA_API_KEY`.

## Keeping this skill current

This skill is served by the product and can change without notice. If a request fails in a way
this document does not describe — an unknown field, an unexpected status or error code, or a
route that returns `404` — the skill may be stale. Re-fetch it, paste the new version into the
conversation, and re-read it before retrying:

```sh
curl -fsSL https://dreamutopia.net/skills/dreamutopia/cursor.md
```

Do not invent request fields from memory. The re-fetched file is the current contract; the copy
in the conversation is only a snapshot.

## 1. Upload a local reference image (optional)

Only needed when the user has a local file. A previous generation's `result.url` can be used
directly instead.

```sh
curl -sS -X POST https://api.dreamutopia.net/v1/uploads \
  -H "Authorization: Bearer $DREAMUTOPIA_API_KEY" \
  -F "file=@/path/to/photo.png"
```

Response `201`:

```json
{ "id": "<upload_id>",
  "url": "<upload_url>",
  "expires_at": "2026-10-31T12:00:00Z" }
```

Use `id` (not `url`) in the next request. Accepted: JPEG, PNG, WebP, up to 30 MB.
`id` only works for the account that uploaded it.

## 2. Create an image

```sh
curl -sS -X POST https://api.dreamutopia.net/v1/images/generations \
  -H "Authorization: Bearer $DREAMUTOPIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "lite",
    "prompt": "a red fox in fresh snow, cinematic",
    "resolution": "2k",
    "aspect_ratio": "1:1"
  }'
```

| Field | Values |
|---|---|
| `model` | `lite`, `pro` |
| `resolution` | `2k`, `4k` (`lite` accepts `2k` only) |
| `aspect_ratio` | `1:1`, `4:3`, `3:4`, `16:9`, `9:16`, `3:2`, `2:3`, `adaptive` |
| `reference_images` | array of upload ids or DreamUtopia URLs; 0–3 for `lite`, 0–14 for `pro` |
| `prompt` | non-empty, up to 8000 characters |

`adaptive` requires at least one reference image. `resolution` defaults to `2k` and
`aspect_ratio` to `1:1`.

Response `202`:

```json
{ "id": "3f2b…", "type": "image", "status": "queued", "created_at": "2026-10-24T12:00:00Z" }
```

## 3. Create a video

```sh
curl -sS -X POST https://api.dreamutopia.net/v1/videos/generations \
  -H "Authorization: Bearer $DREAMUTOPIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "medium",
    "prompt": "the fox turns and looks at the camera",
    "image": "<upload_id>",
    "resolution": "720p",
    "duration": 8
  }'
```

| Field | Values |
|---|---|
| `model` | `lite`, `medium`, `pro` |
| `resolution` | `480p`, `720p`, `1080p` (`lite` cannot use `1080p`) |
| `duration` | 5–10 seconds (`lite`), 5–15 (`medium`), 5–30 (`pro`) |
| `image` | first-frame upload id or DreamUtopia URL (omit for text-to-video) |
| `last_frame_image` | requires `image`; not supported by `lite` |
| `generate_audio` | `pro` only, and the account must hold premium; `lite` and `medium` are rejected |

Response `202` with `type: "video"`.

## 4. Poll until it finishes

```sh
curl -sS https://api.dreamutopia.net/v1/generations/$MID \
  -H "Authorization: Bearer $DREAMUTOPIA_API_KEY"
```

`status` is one of `queued`, `processing`, `succeeded`, `failed`.

- Poll every 3–5 seconds, backing off to 10 seconds. Give up after about 10 minutes.
- On `succeeded`, download `result.url`. The link is valid for 7 days.
- On `failed`, report `error.message` to the user and stop. A failed job is terminal; do
  **not** submit it again automatically.
- If an id is lost, `GET /generations?limit=20` lists recent jobs, newest first.

Terminal response:

```json
{
  "id": "3f2b…",
  "type": "video",
  "status": "succeeded",
  "model": "medium",
  "credits_used": 12,
  "created_at": "2026-10-24T12:00:00Z",
  "updated_at": "2026-10-24T12:02:10Z",
  "result": { "url": "<result_url>" },
  "error": null
}
```

## 5. Check credits and prices

```sh
curl -sS https://api.dreamutopia.net/v1/account -H "Authorization: Bearer $DREAMUTOPIA_API_KEY"
curl -sS https://api.dreamutopia.net/v1/models
```

`/models` is public and returns every tier's allowed resolutions and durations plus the
`resolution → duration → credits` matrix. Check it before choosing settings when the user
cares about cost.

## Errors

Every error body is exactly:

```json
{ "error": { "code": "insufficient_credits", "message": "You need more credits to generate." } }
```

| HTTP | Meaning |
|---|---|
| 400 | invalid input (`invalid_request`, `prompt_too_long`, `invalid_reference_image`, …) |
| 401 | missing, malformed, revoked or removed-account key |
| 402 | not enough credits |
| 403 | unpaid key creation, or audio requested without premium |
| 404 | unknown job, or a job belonging to another account |
| 409 | `Idempotency-Key` reused with a different body, or still in flight |
| 413 / 415 | upload too large / not a supported image |
| 429 | rate limited; read `Retry-After` |
| 500 / 503 | internal; retry later |

Retry only HTTP `429`, `timeout` and `internal` responses. Never retry
`insufficient_credits`, and never resubmit a job that already finished as `failed`.

## Idempotency

Send `Idempotency-Key: <unique value>` on a create request. A retry with the same key and
body returns the existing job (`200`) instead of creating and charging a second one. Use a
fresh value for every genuinely different request.

## Complete example

```sh
#!/usr/bin/env bash
set -euo pipefail
: "${DREAMUTOPIA_API_KEY:?set DREAMUTOPIA_API_KEY first}"
API="https://api.dreamutopia.net/v1"

ID=$(curl -sS -X POST "$API/images/generations" \
  -H "Authorization: Bearer $DREAMUTOPIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"lite","prompt":"a red fox in fresh snow","resolution":"2k","aspect_ratio":"1:1"}' \
  | jq -r .id)

while :; do
  BODY=$(curl -sS "$API/generations/$ID" -H "Authorization: Bearer $DREAMUTOPIA_API_KEY")
  STATUS=$(jq -r .status <<<"$BODY")
  case "$STATUS" in
    succeeded) jq -r .result.url <<<"$BODY"; break ;;
    failed)    jq -r .error.message <<<"$BODY" >&2; exit 1 ;;
    *)         sleep 4 ;;
  esac
done
```

Другие инструменты

Выберите инструмент для следующего шага.

Часто задаваемые вопросы

От команды DreamUtopia · Последнее обновление 15 ноября 2026 г.

Нужен ли мне сервер MCP, чтобы использовать DreamUtopia из Cursor?

▼
Нет. API — это обычный HTTP, и навык учит Cursor вызывать его через curl. Вам не нужен MCP-сервер, бинарник CLI или плагин. Единственная настройка — вставить навык и переменную окружения.

Куда должен попасть файл навыка в Cursor?

▼
Вставьте блок навыка в чат Cursor. Он действует для этого разговора; повторите вставку в новом сеансе. Ничего не добавляется в ваш репозиторий, и не нужно создавать никаких файлов. Храните API-ключ в окружении оболочки как DREAMUTOPIA_API_KEY, а не во вставленном тексте.

Может ли Cursor загрузить локальное изображение?

▼
Да. Попросите его использовать файл в проекте. Агент отправляет multipart-загрузку, получает идентификатор загрузки и использует этот идентификатор при генерации. Принимаются JPEG, PNG и WebP размером до 30 МБ.

Навык генерирует видео так же, как и изображения?

▼
Да. Один и тот же ключ покрывает преобразование текста в видео и изображения в видео, с длительностью от пяти до пятнадцати секунд в зависимости от уровня модели. Переходы от первого к последнему кадру доступны на более высоких уровнях.

Как списываются кредиты?

▼
Списание кредитов происходит при создании задачи и возвращается в случае её сбоя. Актуальная матрица цен доступна по GET /v1/models, и навык проверяет её, когда вы спрашиваете о стоимости. Перед созданием ключа требуется платная учётная запись.

Что произойдёт, если я закрою сеанс?

▼
Задание продолжает выполняться на наших серверах. Используйте GET /v1/generations/{id} с идентификатором или просмотрите список последних заданий с помощью GET /v1/generations?limit=20. Подписанный URL результата остаётся действительным в течение семи дней.

Безопасно ли отзывать ключ?

▼
Да. Отзыв немедленно останавливает новые запросы и не затрагивает выполняющиеся задачи. Аккаунт может содержать несколько ключей, поэтому одну интеграцию можно вывести из эксплуатации, не затрагивая остальные.

Дайте Cursor медиаинструмент

Создайте ключ, вставьте навык и запросите своё первое изображение. Документация API охватывает каждое поле, статус и код ошибки.