🎉 각 팩 첫 구매 시 무료 생성 선물 — 최대 Lite 영상 20개 + Lite 이미지 20개 + Medium 영상 10개 + Pro 이미지 10개 + Pro 영상 2개.

시작하기
DreamUtopia
ko

Cursor가 이제 동영상을 생성할 수 있습니다

Cursor는 이미 편집기에서 작동합니다. DreamUtopia REST API를 사용하면 동일한 세션에서 제품 사진을 짧은 클립으로 바꾸거나, 인물 사진을 애니메이션화하거나, 완성된 이미지를 첫 프레임 비디오로 연결할 수 있습니다. 스킬 파일 하나를 붙여넣고 평범한 영어로 요청하면 에이전트가 업로드, 요청, 폴링을 처리합니다. 렌더가 우리 서버에서 실행되는 동안에도 같은 대화에서 계속 작업할 수 있습니다.

실제 예시로 시작하기

이 페이지의 예시에 사용된 프롬프트입니다. 생성기를 열고 예시를 선택한 다음, 세부 사항을 하나씩 바꿔 보세요.

황금 시간의 해안 도로, 카메라가 앞으로 천천히 이동하며 절벽 아래로 바다가 반짝인다.

예시 프롬프트 01

황금 시간의 해안 도로, 카메라가 앞으로 천천히 이동하며 절벽 아래로 바다가 반짝인다.

일출 무렵 안개 낀 포도밭 위를 떠다니는 열기구, 그 모습이 아래 강물 위로 비쳐 움직인다.

예시 프롬프트 02

일출 무렵 안개 낀 포도밭 위를 떠다니는 열기구, 그 모습이 아래 강물 위로 비쳐 움직인다.

해질녘의 종이 등 축제, 카메라가 따뜻한 하늘을 향해 기울어지며 등불이 떠오른다.

예시 프롬프트 03

해질녘의 종이 등 축제, 카메라가 따뜻한 하늘을 향해 기울어지며 등불이 떠오른다.

에디터를 떠나지 않고 커서로 영상 생성하기

에이전트가 미디어 API를 직접 호출할 수 있게 되면 Cursor 비디오 생성은 코딩 세션의 자연스러운 일부가 됩니다. 코딩 에이전트는 명령을 실행하고, JSON 응답을 읽고, 판단을 가지고 재시도하는 데 능숙하며, 이는 바로 이미지-투-비디오 API에 필요한 것입니다. 편집기를 떠나 웹 앱을 열지 않고도 Cursor에게 ./photo.png를 5초짜리 720p 클립으로 변환해 달라고 요청하고 같은 대화에서 서명된 결과 URL을 돌려받을 수 있습니다. 우리가 DreamUtopia API를 순수 REST로 구축한 이유가 바로 이것입니다. 구성할 MCP 서버도, 설치할 플러그인도 없습니다. 하나의 스킬 파일이 에이전트에게 기본 URL, 인증 헤더, 참조 이미지용 멀티파트 업로드, 비디오 생성 엔드포인트, 공유 작업 엔드포인트 및 종료 상태 규칙을 가르칩니다. 붙여넣은 스킬 하나와 환경 변수 하나가 설정의 전부입니다. 동일한 키가 자체 스크립트에서도 작동하므로, 에이전트와 빌드 파이프라인이 하나의 통합과 하나의 크레딧 잔액을 공유합니다. 비디오 작업은 이미지 작업보다 느리며, 보통 1분에서 3분 사이이므로 폴링 루프가 중요합니다. 스킬은 에이전트에게 백오프로 대기하고, 종료 실패 시 중단하며, 콘텐츠 정책 거부나 빈 잔액에 대해서는 절대 재시도하지 말라고 알려줍니다. 또한 여전히 대기 중인 작업과 진행이 멈춘 작업을 구분합니다. 그 구분이 차분한 대기와 재시도 폭풍의 차이입니다. 무분별하게 재시도하는 폴링 루프는 첫 렌더가 완료되기 전에 허용량을 소진할 수 있으며, 너무 일찍 중단하는 루프는 여전히 진행 중이던 작업을 포기합니다. 코드와 함께 미디어를 배포하는 저장소의 경우, 실질적인 이점은 컴포넌트를 작성하는 사람이 변경의 맥락을 잃거나 도구 간에 파일을 복사하지 않고도 필요한 클립을 생산할 수 있다는 것입니다. 에이전트는 실패한 렌더를 실패한 테스트에 사용하는 것과 같은 어조로 설명할 수 있으며, 결과를 이를 참조하는 코드 옆에 유지할 수 있습니다.

무엇을 얻을 수 있나요

복사-붙여넣기 기술 하나

아래 스킬 블록을 Cursor 채팅에 붙여넣으세요. 에이전트는 추가 프롬프트 없이 대화의 나머지 부분 동안 레시피를 따릅니다. 텍스트는 한 번에 읽을 수 있을 만큼 짧고, 에이전트가 필드 이름을 임의로 만들지 않을 만큼 구체적입니다. 각 필드가 허용하는 정확한 값을 명시하므로, 잘못된 요청은 API에 도달하기 전에 수정됩니다. 저장소에 아무것도 기록되지 않고 아무것도 설치되지 않습니다.

로컬 사진 처리됨

에이전트에게 프로젝트 내 파일을 사용하도록 요청하세요. 에이전트는 멀티파트 업로드를 전송하고 업로드 id를 받은 뒤, 해당 id를 첫 프레임으로 사용합니다. JPEG, PNG, WebP는 최대 30MB까지 허용됩니다. 리포지토리 내 파일은 먼저 공개 URL이 필요하지 않으므로, 비공개 제품 사진을 별도의 호스팅 단계 없이 유지할 수 있습니다.

모든 비디오 형태

이미지-투-비디오, 텍스트-투-비디오 및 첫-프레임-마지막-프레임 전환은 하나의 키를 공유합니다. 480p, 720p 또는 1080p와 5초에서 15초 사이의 길이를 선택하세요. Lite 티어는 720p와 10초에서 상한이 적용되며, Medium과 Pro는 1080p와 15초에 도달합니다. 이 스킬은 추측하는 대신 실시간 모델 목록에서 해당 상한을 읽어옵니다.

채팅보다 오래 살아남는 일자리

모든 렌더는 우리 서버에서 실행됩니다. 세션이 종료되면 에이전트는 id로 최근 작업을 나열하고 나중에 결과를 수집할 수 있습니다. 서명된 링크는 7일 동안 유효하며, 파일을 다운로드하거나 빌드 아티팩트에 복사하기에 충분히 깁니다. 실패한 작업은 오류 코드를 유지하므로 다음 세션에서 무슨 일이 있었는지 설명할 수 있습니다. 렌더가 완료될 때까지 몇 분 동안 터미널을 열어 두는 것보다 나중에 결과를 수집하는 것이 더 안전합니다. 특히 원격 머신이나 간헐적인 연결 환경에서는 더욱 그렇습니다.

평이한 영어로 된 모션

샷을 설명하세요, API가 아니라: 천천히 밀어 넣기, 오른쪽으로 드리프트, 바람에 흔들리는 머리카락. 이 스킬은 당신의 말을 모델 티어, 해상도, 길이, 화면 비율에 매핑한 다음, 지출하기 전에 실시간 가격 매트릭스를 확인합니다. 작업에 정확한 설정이 필요할 때는 여전히 직접 지정할 수 있으며, 에이전트는 자신이 선택한 설정을 보고하므로 예상치 못한 결과를 더 쉽게 진단할 수 있습니다. 모호한 요청은 잘못된 길이에 크레딧을 소모하는 추측성 렌더링 대신, 한 번의 명확화 질문으로 해결됩니다.

하나의 가격표

API와 웹 앱은 동일한 크레딧을 청구합니다. GET /v1/models는 실시간 해상도, 길이 및 크레딧 매트릭스를 반환하므로, 에이전트는 무엇이든 생성하기 전에 5초 클립과 10초 클립을 비교할 수 있습니다. 크레딧은 작업이 생성될 때 청구되며 실패하면 자동으로 반환됩니다.

작동 방식

1

키 생성 및 내보내기

프로필 열기, 그다음 API keys, 그리고 이름이 지정된 키를 생성하세요. Cursor를 실행하는 셸에서 이를 DREAMUTOPIA_API_KEY로 내보내세요. 키는 유료 계정에서 사용할 수 있으며, 한 번만 표시되고, 다른 통합에 영향을 주지 않고 폐기할 수 있습니다.

2

스킬을 붙여넣으세요

아래 블록을 복사하여 Cursor 채팅에 붙여넣으세요. 그러면 에이전트가 해당 대화에 대한 엔드포인트, 필드 이름 및 폴링 규칙을 알게 됩니다. 이 스킬은 하지 말아야 할 일도 명시합니다: 거부된 작업을 재시도하지 말고, 키를 대화에 붙여넣지 마세요. 새 세션에서 다시 붙여넣으세요. 저장소에는 아무것도 추가되지 않습니다.

3

클립을 요청하세요

일반적인 요청을 작성하세요: ./hero.png를 눈이 내리는 6초 세로 클립으로 변환합니다. 에이전트가 설정을 선택하고, 먼저 /v1/models를 확인할 수 있으며, 소스가 로컬 파일일 때 업로드를 처리합니다. 요청이 모호한 경우, 길이나 화면 비율을 추측하지 않고 짧은 질문 하나를 합니다.

4

투표하고 결과를 사용하세요

에이전트는 작업이 성공할 때까지 GET /v1/generations/{id}를 폴링한 다음 서명된 결과 URL을 반환합니다. 폴링 사이에 백오프하며, 콘텐츠 정책 거부나 소진된 잔액에 대해서는 재시도하지 않고 최종 실패 시 중단합니다. 최종 답변에는 링크뿐만 아니라 작업 id도 포함되므로 대화가 사라진 후에도 결과를 다시 찾을 수 있습니다.

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 팀 작성 · 마지막 업데이트 2026년 11월 15일

Cursor에서 비디오를 생성하려면 MCP 서버가 필요한가요?

▼
아니요. API는 일반 HTTP이고, 스킬은 Cursor에게 curl로 그것을 호출하는 방법을 가르칩니다. MCP 서버, CLI 바이너리 또는 플러그인이 필요하지 않습니다. 유일한 설정은 스킬과 환경 변수를 붙여넣는 것입니다.

API 키는 어디에 있어야 합니까?

▼
셸 환경에서 DREAMUTOPIA_API_KEY로 설정하세요. 붙여넣는 스킬, 저장소, 프롬프트에는 이 키를 넣지 마세요. 이 스킬은 해당 변수가 없으면 에이전트에게 중단하고 질문하도록 지시하여, 반쯤 구성된 요청이 발생하는 것을 방지합니다.

에이전트가 로컬 사진을 첫 프레임으로 업로드할 수 있나요?

▼
예. 프로젝트 내의 파일을 사용하도록 요청하세요. 에이전트는 멀티파트 업로드를 전송하고 업로드 ID를 받은 다음, 그 ID를 비디오 요청에 전달합니다. JPEG, PNG, WebP는 최대 30MB까지 허용되며, 이는 대부분의 카메라 및 제품 이미지를 커버합니다.

생성된 클립은 얼마나 길 수 있나요?

▼
Lite, Med, Pro 등급에 따라 5초에서 15초까지입니다. Lite 등급은 10초에서 멈추고, Medium과 Pro는 15초에 도달합니다. 이 스킬은 요청을 보내기 전에 GET /v1/models에서 상한을 읽으므로, 초과된 길이는 거부되지 않고 수정됩니다.

어떤 해상도를 사용할 수 있나요?

▼
480p, 720p 및 1080p. Lite 티어는 720p까지 지원하며, Medium과 Pro는 1080p로 렌더링합니다. 화면 비율은 기본적으로 적응형이며, 에이전트는 대상이 알려진 경우 세로, 정사각형 또는 가로 프레임을 선택할 수 있습니다.

비디오에 대한 크레딧은 어떻게 청구되나요?

▼
작업이 생성될 때 크레딧이 청구되며, 실패하면 자동으로 반환됩니다. 실시간 가격 매트릭스는 GET /v1/models에서 확인할 수 있으며, 비용에 대해 문의하시면 스킬이 이를 확인합니다. 키를 생성하려면 유료 계정이 필요합니다.

세션을 닫으면 어떻게 되나요?

▼
작업은 저희 서버에서 계속 실행됩니다. id와 함께 GET /v1/generations/{id}를 사용하거나, GET /v1/generations?limit=20으로 최근 작업 목록을 조회하세요. 서명된 결과 URL은 7일 동안 유효하므로 결과를 수집하는 데 서두를 필요가 없습니다.

Cursor에 비디오 도구 제공

키를 생성하고, 스킬을 붙여넣은 다음, 첫 클립을 요청하세요. API 문서에는 모든 필드, 상태 및 오류 코드가 포함되어 있습니다.