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

시작하기
DreamUtopia
ko

Windsurf, 이제 동영상 생성 가능

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

실제 예시로 시작하기

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

황혼 무렵의 종이 등불 축제, 카메라가 따뜻한 하늘을 향해 위로 기울어지며 등불이 떠오른다.

예시 프롬프트 01

황혼 무렵의 종이 등불 축제, 카메라가 따뜻한 하늘을 향해 위로 기울어지며 등불이 떠오른다.

속도에 맞춰 달리는 빈티지 기차 창문, 유리창 밖으로 김이 피어오르는 동안 들판이 흐릿하게 스쳐 지나간다.

예시 프롬프트 02

속도에 맞춰 달리는 빈티지 기차 창문, 유리창 밖으로 김이 피어오르는 동안 들판이 흐릿하게 스쳐 지나간다.

에디터를 떠나지 않고, Windsurf 비디오 생성

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

무엇을 얻을 수 있나요

복사-붙여넣기 스킬 하나

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

로컬 사진 처리됨

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

모든 비디오 형태

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

채팅보다 오래 지속되는 일자리

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

평이한 영어로 된 모션

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

하나의 가격표

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

작동 방식

1

키 생성 및 내보내기

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

2

스킬을 붙여넣으세요

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

3

클립을 요청하세요

일반적인 요청을 작성하세요: ./portrait.png를 애니메이션으로 만들고, 머리카락이 바람에 움직이며, 5초 길이로. 에이전트가 설정을 선택하고, 먼저 /v1/models를 확인할 수 있으며, 소스가 로컬 파일일 때 업로드를 처리합니다. 요청이 모호하면 길이나 화면 비율을 추측하지 않고 짧은 질문을 하나 합니다.

4

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

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

Windsurf에 DreamUtopia Skill을 붙여넣으세요

아래 스킬을 복사해서 Windsurf 채팅에 붙여넣으세요. 그러면 에이전트는 대화가 진행되는 동안 API 표면, 동영상 상한, 오류 규칙, 그리고 재시도하지 말아야 할 시점을 알게 됩니다.

Paste into Windsurf
Download
> Paste this into the Windsurf 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/windsurf.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일

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

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

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

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

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

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

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

▼
티어에 따라 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일 동안 유효하므로 결과를 수집하기 위해 서두를 필요가 없습니다.

Windsurf에 비디오 도구 제공

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