🎉 Бесплатные генерации при первой покупке каждого пакета — до 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. Агенты для программирования хорошо справляются с выполнением команд, чтением JSON-ответов и повторными попытками с учётом обстоятельств — именно это и нужно API преобразования изображения в видео. Вместо того чтобы покидать терминал и открывать веб-приложение, вы можете попросить Claude Code превратить ./photo.png в пятисекундный клип 720p и получить обратно подписанный URL результата в том же диалоге. Именно поэтому мы создали DreamUtopia API как обычный REST. Здесь нет MCP-сервера для настройки и нет плагина для установки. Один файл навыка учит агента базовому URL, заголовку аутентификации, multipart-загрузке референсных изображений, эндпоинту создания видео, общему эндпоинту задач и правилам терминальных состояний. Один вставленный навык и одна переменная окружения — это вся настройка. Тот же ключ также работает из ваших собственных скриптов, поэтому агент и ваш сборочный конвейер используют одну интеграцию и один баланс кредитов. Задача генерации видео медленнее задачи генерации изображения, обычно от одной до трёх минут, поэтому цикл опроса имеет значение. Навык велит агенту ждать с экспоненциальной задержкой, останавливаться при терминальной ошибке и никогда не повторять отказ по политике контента или при пустом балансе. Он также отличает задачу, которая всё ещё в очереди, от той, что перестала продвигаться. Это различие — разница между спокойным ожиданием и штормом повторных попыток. Цикл опроса, который повторяет попытки без разбора, может израсходовать лимит до завершения первого рендера, тогда как цикл, который останавливается слишком рано, бросает задачу, которая всё ещё продвигалась. Для репозитория, который поставляет медиа вместе с кодом, практическая выгода в том, что человек, пишущий компонент, может также создать нужный ему клип, не теряя контекста изменения и не копируя файлы между инструментами. Агент может объяснить неудачный рендер тем же голосом, каким он объясняет неудачный тест, и может хранить результат рядом с кодом, который на него ссылается.

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

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

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

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

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

Каждый формат видео

Преобразование изображения в видео, преобразование текста в видео и переходы между первым и последним кадром используют один ключ. Выберите 480p, 720p или 1080p и длительность от пяти до пятнадцати секунд. Уровень Lite ограничен 720p и десятью секундами; Medium и Pro достигают 1080p и пятнадцати секунд. Навык считывает эти ограничения из актуального списка моделей, а не угадывает их.

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

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

Понятное движение

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

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

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

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

1

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

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

2

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

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

3

Попросить клип

Напиши обычный запрос: преврати ./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-сервер, чтобы генерировать видео из Claude Code?

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

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

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

Может ли агент загрузить локальное фото в качестве первого кадра?

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

Какова максимальная длительность сгенерированного клипа?

▼
От пяти до пятнадцати секунд в зависимости от уровня. Уровень Lite останавливается на десяти секундах; Medium и Pro достигают пятнадцати. Навык считывает верхний предел из GET /v1/models перед отправкой запроса, поэтому слишком длительная продолжительность корректируется, а не отклоняется.

Какие разрешения доступны?

▼
480p, 720p и 1080p. Уровень Lite ограничен 720p, тогда как Medium и Pro рендерят в 1080p. Соотношение сторон по умолчанию адаптивное, и агент может выбрать портретный, квадратный или альбомный кадр, когда место назначения известно.

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

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

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

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

Дайте Claude Code инструмент для работы с видео

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