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

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

OpenCode теперь умеет генерировать видео

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

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

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

Прибрежная дорога в золотой час, камера плавно движется вперёд, а внизу под скалами поблёскивает океан.

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

Прибрежная дорога в золотой час, камера плавно движется вперёд, а внизу под скалами поблёскивает океан.

Воздушный шар, плывущий над туманными виноградниками на рассвете, его отражение скользит по реке внизу.

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

Воздушный шар, плывущий над туманными виноградниками на рассвете, его отражение скользит по реке внизу.

Фестиваль бумажных фонариков в сумерках, фонарики поднимаются вверх, а камера наклоняется вверх в тёплое небо.

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

Фестиваль бумажных фонариков в сумерках, фонарики поднимаются вверх, а камера наклоняется вверх в тёплое небо.

Генерация видео OpenCode, не выходя из терминала

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

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

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

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

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

Попросите агента использовать файл в проекте. Он отправляет multipart-загрузку, получает upload id и использует этот id в качестве первого кадра. Принимаются 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 в оболочке, из которой запускается OpenCode. Ключи доступны платным аккаунтам, показываются один раз и могут быть отозваны без затрагивания других ваших интеграций.

2

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

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

3

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

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

4

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

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

Вставьте DreamUtopia Skill в OpenCode

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

Paste into OpenCode
Download
> Paste this into the OpenCode 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/opencode.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 для генерации видео из OpenCode?

▼
Нет. API — это обычный HTTP, и навык учит OpenCode вызывать его через 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, и skill проверяет её, когда вы спрашиваете о стоимости. Перед созданием ключа требуется платная учётная запись.

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

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

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

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