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

시작하기
DreamUtopia
ko

Codex가 이제 이미지를 생성할 수 있습니다

Codex는 이미 여러분의 코드를 편집합니다. DreamUtopia REST API를 사용하면 같은 세션에서 히어로 이미지를 생성하고, 제품 사진의 스타일을 바꾸거나, 정지 이미지를 8초짜리 영상으로 변환할 수 있습니다. 스킬 파일 하나를 붙여넣고 평범한 영어로 요청하면, 에이전트가 업로드, 요청, 폴링을 처리합니다.

실제 예시로 시작하기

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

이 폭풍우 치는 해안을 황혼 장면으로 다시 그려 주세요. 등대와 검은 바위는 유지하고, 등대 빛이 바다 안개를 가로지르게 하며, 폭풍 구름을 더 깊게 표현하세요.

예시 프롬프트 01

이 폭풍우 치는 해안을 황혼 장면으로 다시 그려 주세요. 등대와 검은 바위는 유지하고, 등대 빛이 바다 안개를 가로지르게 하며, 폭풍 구름을 더 깊게 표현하세요.

이 주방 조리대를 아늑한 가을 장면으로 바꿔 주세요. 흰 머그컵과 나무 조리대는 유지하고, 흩어진 시나몬 스틱과 린넨 천을 추가하며, 더 따뜻하고 낮은 햇살을 넣어 주세요.

예시 프롬프트 02

이 주방 조리대를 아늑한 가을 장면으로 바꿔 주세요. 흰 머그컵과 나무 조리대는 유지하고, 흩어진 시나몬 스틱과 린넨 천을 추가하며, 더 따뜻하고 낮은 햇살을 넣어 주세요.

이 고산 호수를 느슨한 수채화로 그려 주세요. 봉우리와 반영은 유지하고, 소나무는 부드럽게 표현하며, 새벽빛은 따뜻하게 해 주세요.

예시 프롬프트 03

이 고산 호수를 느슨한 수채화로 그려 주세요. 봉우리와 반영은 유지하고, 소나무는 부드럽게 표현하며, 새벽빛은 따뜻하게 해 주세요.

터미널을 떠나지 않고 하는 Codex 이미지 생성

Codex 이미지 생성은 에이전트가 미디어 API를 직접 호출할 수 있을 때 코딩 세션의 자연스러운 일부가 됩니다. 코딩 에이전트는 명령 실행, 응답 읽기, 지능적 재시도에 능숙하며, 이는 바로 미디어 API에 필요한 것입니다. 터미널을 떠나 웹 앱을 여는 대신, Codex에 16:9 헤더 이미지를 요청하고 같은 대화에서 결과 URL을 받을 수 있습니다. 바로 이런 이유로 DreamUtopia API를 순수 REST로 구축했습니다. 구성할 MCP 서버도, 설치할 플러그인도 없습니다. 스킬 파일은 에이전트에게 기본 URL, 인증 헤더, 멀티파트 업로드, 두 개의 생성 엔드포인트, 폴링 루프, 오류 규칙을 가르칩니다. 스킬 하나를 붙여넣고 환경 변수 하나를 설정하면 전체 설정이 끝납니다. 같은 키는 자체 스크립트에서도 작동하므로, 에이전트와 빌드 파이프라인이 하나의 통합과 하나의 크레딧 잔액을 공유합니다. 이는 디자인 작업이 채팅에서 시작해 배포 스크립트에서 끝날 때 중요합니다. 두 경우 사이에 요청 형태가 바뀌지 않기 때문입니다. 이 워크플로는 코딩 에이전트가 이미 작동하는 방식에도 맞습니다. 요청은 일반 셸 명령이고, 실패는 일반 HTTP 상태이며, 긴 작업은 폴링할 일반 id입니다. 즉 Codex는 실패한 테스트에 사용하는 것과 같은 어조로 실패를 설명할 수 있고, 생성된 에셋을 이를 참조하는 코드 옆에 둘 수 있습니다. 디자인 비중이 큰 저장소에서 그 차이는 겉치레가 아니라 실질적입니다. 컴포넌트를 작성하는 사람이 도구를 전환하거나 변경의 맥락을 잃지 않고 필요한 이미지를 생산할 수 있는 사람이기도 하기 때문입니다. Codex는 부여받은 작업을 떠나지 않고 요청을 실행하고, JSON 응답을 읽고, 실패를 설명할 수 있습니다. 그 피드백 루프가 핵심입니다. 에이전트는 이미 명령을 실행하고 결과를 해석하는 방법을 알고 있으므로, 미디어 생성은 그것이 사용할 수 있는 또 하나의 도구가 됩니다.

무엇을 얻을 수 있나요

복사하여 붙여넣기만 하면 되는 기술 하나

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

로컬 파일 처리됨

에이전트는 멀티파트 요청으로 프로젝트의 사진을 업로드한 다음, 반환된 id를 생성 과정에 전달합니다. JPEG, PNG, WebP의 경우 제한은 30 MB입니다. 저장소에 있는 파일은 먼저 공개 URL이 필요하지 않습니다.

이미지와 동영상, 하나의 키

텍스트-이미지, 이미지-이미지, 텍스트-비디오, 이미지-비디오 및 첫/마지막 프레임 전환은 모두 동일한 키와 동일한 크레딧 잔액을 사용합니다. 스틸 이미지와 모션에 대해 별도의 계정을 관리할 필요가 없으며, 스킬은 완성된 이미지 하나를 다음 비디오 요청으로 연결할 수 있습니다.

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

모든 생성은 우리 서버에서 실행됩니다. 세션이 종료되면 에이전트는 id로 최근 작업 목록을 조회하고 나중에 결과를 수집할 수 있습니다. 서명된 결과 링크는 7일 동안 유효하며, 이는 결과를 다운로드하거나 빌드 아티팩트에 복사하기에 충분한 시간입니다.

쉬운 영어로 된 요청

정사각형 제품 촬영 이미지나 세로형 소셜 클립을 요청하세요. 이 스킬은 입력한 내용을 모델, 해상도, 길이, 화면 비율로 매핑한 뒤, 비용을 지출하기 전에 실시간 가격 매트릭스를 확인합니다. 작업에 정확한 설정이 필요할 때는 여전히 직접 지정할 수 있습니다. 에이전트가 선택한 설정을 다시 알려주므로 예상치 못한 결과가 나왔을 때 원인을 더 쉽게 진단할 수 있습니다.

One price list

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

작동 방식

1

키를 생성하고 내보내기

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

2

스킬을 붙여넣으세요

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

3

필요한 것을 요청하세요

일반적인 요청을 작성하세요: 눈 속의 붉은 여우를 2K 이미지로 생성하거나, ./photo.png를 느린 푸시가 있는 720p 클립으로 변환하세요. 에이전트가 설정을 선택하고, 먼저 /v1/models를 확인할 수 있으며, 소스가 로컬 파일일 때 업로드를 처리합니다. 요청이 모호한 경우, 길이나 화면 비율을 추측하지 않고 짧은 질문을 하나 합니다.

4

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

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

DreamUtopia Skill을 Codex에 붙여넣기

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

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

Codex에서 DreamUtopia를 사용하려면 MCP 서버가 필요한가요?

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

Codex에서 스킬 파일은 어디에 두어야 하나요?

▼
Codex 채팅에 스킬 블록을 붙여넣으세요. 해당 대화에 적용되며, 새 세션에서는 다시 붙여넣어야 합니다. 저장소에는 아무것도 추가되지 않고 파일을 만들 필요도 없습니다. API 키는 붙여넣은 텍스트가 아니라 셸 환경에 DREAMUTOPIA_API_KEY로 보관하세요.

Codex가 로컬 이미지를 업로드할 수 있나요?

▼
예. 프로젝트 내의 파일을 사용하도록 요청하세요. 에이전트가 multipart 업로드를 전송하고 업로드 id를 받은 뒤, 해당 id를 생성에 사용합니다. JPEG, PNG, WebP는 최대 30 MB까지 허용됩니다.

해당 스킬은 이미지뿐만 아니라 동영상도 생성하나요?

▼
예. 동일한 키로 텍스트-투-비디오와 이미지-투-비디오를 모두 사용할 수 있으며, 모델 티어에 따라 5초에서 15초까지의 길이를 지원합니다. 처음-마지막 프레임 전환은 상위 티어에서 사용할 수 있습니다.

크레딧은 어떻게 청구되나요?

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

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

▼
작업은 우리 서버에서 계속 실행됩니다. id와 함께 GET /v1/generations/{id}를 사용하거나 GET /v1/generations?limit=20으로 최근 작업 목록을 조회하세요. 서명된 결과 URL은 7일 동안 유효합니다.

키를 폐기하는 것이 안전한가요?

▼
네. 폐기하면 새 요청은 즉시 중단되고 실행 중인 작업은 그대로 둡니다. 계정 하나에 여러 키를 보유할 수 있어 다른 키는 건드리지 않고 하나의 통합만 종료할 수 있습니다.

Codex에게 미디어 도구를 제공하세요

키를 생성하고, 스킬을 붙여넣은 다음, 첫 번째 이미지를 요청하세요. API 문서에는 모든 필드, 상태 및 오류 코드가 설명되어 있습니다.