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

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

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

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

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

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

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

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

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

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

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

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

Нарисуй эту витрину пекарни заново в виде иллюстрированной открытки. Сохрани вывеску, витрину и тротуар и используй чистые контурные линии с тёплой вечерней палитрой.

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

Нарисуй эту витрину пекарни заново в виде иллюстрированной открытки. Сохрани вывеску, витрину и тротуар и используй чистые контурные линии с тёплой вечерней палитрой.

Генерация изображений в Claude Code без выхода из терминала

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1

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

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

2

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

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

3

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

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

4

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

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

Вставьте DreamUtopia Skill в Claude Code

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

Paste into Claude Code
Download
> Paste this into the Claude Code 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/claude-code.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 из Claude Code?

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

Где должен храниться ключ API?

▼
В окружении оболочки как DREAMUTOPIA_API_KEY. Держите его вне вставляемого навыка, репозитория и промпта. Навык предписывает агенту остановиться и спросить, если переменная отсутствует, что предотвращает наполовину настроенный запрос.

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

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

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

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

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

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

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

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

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

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

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

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