🎉 各パックの初回購入で無料生成ギフト — 最大 Lite 動画 20 本 + Lite 画像 20 枚 + Medium 動画 10 本 + Pro 画像 10 枚 + Pro 動画 2 本。

今すぐ始める
DreamUtopia
ja

Claude Codeで動画を生成できるようになりました

Claude Codeはすでにターミナルで動作しています。DreamUtopia REST APIを使えば、同じセッションで商品写真を短いクリップに変換したり、ポートレートをアニメーション化したり、完成した画像を最初のフレーム動画として連携させたりできます。スキルファイルを1つ貼り付けて、平易な英語で依頼するだけで、エージェントがアップロード、リクエスト、ポーリングを処理します。レンダリングが当社のサーバーで実行されている間も、同じ会話の中で作業を続けられます。

実際の作例から始める

このページの作例に使われているプロンプトです。生成ツールを開いて作例を選び、細部を一つずつ調整してみましょう。

黄金色の時間の海岸道路、カメラが前方へ漂いながら、崖の下で海がきらめく。

プロンプトの例 01

黄金色の時間の海岸道路、カメラが前方へ漂いながら、崖の下で海がきらめく。

日の出の霧のかかったぶどう畑の上を漂う熱気球、その姿が下の川面に映って動いている。

プロンプトの例 02

日の出の霧のかかったぶどう畑の上を漂う熱気球、その姿が下の川面に映って動いている。

夕暮れの紙灯籠祭り、カメラが暖かな空へと上を向くにつれて灯籠が昇っていく。

プロンプトの例 03

夕暮れの紙灯籠祭り、カメラが暖かな空へと上を向くにつれて灯籠が昇っていく。

ターミナルを離れずにClaude Codeで動画生成

Claude Codeの動画生成は、エージェントがメディアAPIを直接呼び出せるようになると、コーディングセッションの通常の一部になります。コーディングエージェントはコマンドの実行、JSONレスポンスの読み取り、判断を伴うリトライが得意であり、これはまさにimage-to-video APIに必要なものです。ターミナルを離れてWebアプリを開く代わりに、Claude Codeに./photo.pngを5秒の720pクリップに変換するよう依頼し、同じ会話の中で署名付きの結果URLを受け取ることができます。私たちがDreamUtopia APIをプレーンなRESTとして構築したのはこのためです。設定すべきMCPサーバーも、インストールすべきプラグインもありません。1つのスキルファイルが、エージェントにベースURL、認証ヘッダー、参照画像用のmultipartアップロード、動画作成エンドポイント、共有ジョブエンドポイント、そして終端状態のルールを教えます。貼り付けた1つのスキルと1つの環境変数が、セットアップのすべてです。同じキーは自分のスクリプトからも機能するため、エージェントとビルドパイプラインが1つの統合と1つのクレジット残高を共有します。動画ジョブは画像ジョブより遅く、通常は1〜3分かかるため、ポーリングループが重要になります。スキルはエージェントに対し、バックオフを伴って待機すること、終端の失敗で停止すること、コンテンツポリシーによる拒否や残高不足に対して決してリトライしないことを指示します。また、まだキューに入っているジョブと、進行が止まったジョブを区別します。この区別が、穏やかな待機とリトライの嵐を分けるのです。無差別にリトライするポーリングループは、最初のレンダリングが完了する前に許容量を消費してしまう可能性があり、逆に早すぎる停止をするループは、まだ進行中だったジョブを放棄してしまいます。コードとともにメディアを提供するリポジトリにとっての実用的な利点は、コンポーネントを書いている人自身が、変更のコンテキストを失うこともツール間でファイルをコピーすることもなく、必要なクリップを生成できることです。エージェントは、失敗したテストに対して使うのと同じ口調で失敗したレンダリングを説明でき、結果をそれを参照するコードの隣に置いておくことができます。

得られるもの

コピペだけで使えるスキルを1つ

以下のスキルブロックをClaude Codeのチャットに貼り付けてください。エージェントは、追加のプロンプトなしで会話の残りの間、そのレシピに従います。テキストは一息で読めるほど短く、エージェントがフィールド名を即興で決めないほど具体的です。各フィールドが受け入れる正確な値が記載されているため、不正なリクエストはAPIに到達する前に修正されます。リポジトリには何も書き込まれず、何もインストールされません。

ローカル写真を処理しました

エージェントにプロジェクト内のファイルを使うよう指示します。マルチパートアップロードを送信し、アップロードIDを受け取り、そのIDを最初のフレームとして使用します。JPEG、PNG、WebPは最大30 MBまで受け付けられます。リポジトリ内のファイルは事前に公開URLを用意する必要がないため、非公開の商品画像を別途ホスティングする手間が省けます。

すべての動画フォーマット

画像から動画、テキストから動画、および最初と最後のフレーム間のトランジションは1つのキーを共有します。480p、720p、または1080pを選択し、5秒から15秒までの duration を指定します。Lite ティアは720pと10秒が上限です。Medium と Pro は1080pと15秒に達します。このスキルはそれらの上限を推測するのではなく、ライブのモデルリストから読み取ります。

チャットより長く続く仕事

すべてのレンダリングは当社のサーバー上で実行されます。セッションが終了しても、エージェントは最近のジョブをidで一覧表示し、後で結果を収集できます。署名付きリンクは7日間有効で、ファイルをダウンロードしたりビルドアーティファクトにコピーしたりするのに十分な長さです。失敗したジョブはエラーコードを保持するため、次のセッションで何が起きたかを説明できます。また、レンダリングの完了を数分間ターミナルを開いたまま待つよりも、後で結果を収集する方が安全です。特にリモートマシンや断続的な接続ではなおさらです。

平易な英語のモーション

ショットを描写してください、APIではなく:ゆっくりとしたプッシュイン、右へのドリフト、風になびく髪。このスキルはあなたの言葉をモデルのティア、解像度、尺、アスペクト比にマッピングし、消費する前にライブの価格マトリクスを確認します。タスクに必要な場合は正確な設定を指定することもでき、エージェントは選択した設定を報告するため、予期しない結果の診断が容易になります。曖昧なリクエストは、間違った尺にクレジットを消費する投機的なレンダリングではなく、1つの確認質問で解決されます。

価格表1件

APIとWebアプリは同じクレジットを消費します。GET /v1/models は最新の解像度、長さ、クレジットのマトリックスを返すため、エージェントは何かを作成する前に5秒のクリップと10秒のクリップを比較できます。クレジットはジョブの作成時に課金され、失敗した場合は自動的に返還されます。

仕組み

1

キーを作成してエクスポートする

プロフィールを開き、次にAPIキーを開いて、名前付きキーを作成します。Claude Codeを起動するシェルで、それをDREAMUTOPIA_API_KEYとしてエクスポートします。キーは有料アカウントで利用可能で、一度だけ表示され、他の連携に影響を与えることなく失効できます。

2

スキルを貼り付けてください

以下のブロックをコピーして、Claude Codeのチャットに貼り付けてください。エージェントはその会話のエンドポイント、フィールド名、ポーリングルールを把握します。このスキルは、やってはいけないことも明示しています。拒否されたジョブを再試行しないこと、キーを会話に貼り付けないことです。新しいセッションで再度貼り付けてください。リポジトリには何も追加されません。

3

クリップをリクエストする

通常のリクエストを書いてください: ./photo.png を8秒の720pクリップに変換し、ゆっくりとしたプッシュインをかけます。エージェントは設定を選択し、最初に /v1/models を確認でき、ソースがローカルファイルの場合はアップロードを処理します。リクエストが曖昧な場合は、再生時間やアスペクト比を推測するのではなく、短い質問を1つします。

4

投票して結果を使用する

エージェントはジョブが成功するまで GET /v1/generations/{id} をポーリングし、その後、署名付きの結果URLを返します。ポーリングの間隔はバックオフし、コンテンツポリシーによる拒否や残高不足の場合は再試行せず、終端エラーで停止します。最終的な回答にはジョブIDとリンクの両方が含まれるため、会話が終了した後でも結果を再び見つけることができます。

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 チームより · 最終更新:2026年11月15日

Claude Codeから動画を生成するにはMCPサーバーが必要ですか?

▼
いいえ。APIはプレーンHTTPであり、このスキルはClaude Codeにcurlでそれを呼び出す方法を教えます。MCPサーバー、CLIバイナリ、プラグインは必要ありません。唯一の設定はスキルと環境変数を貼り付けることだけです。

APIキーはどこに置くべきですか?

▼
シェル環境ではDREAMUTOPIA_API_KEYとして設定します。貼り付けるスキル、リポジトリ、プロンプトには含めないでください。このスキルは、変数が存在しない場合にエージェントへ停止して確認するよう指示するため、設定が不完全なリクエストを防ぐことができます。

エージェントはローカルの写真を最初のフレームとしてアップロードできますか?

▼
はい。プロジェクト内のファイルを使うように指示してください。エージェントはマルチパートアップロードを送信し、アップロードIDを受け取り、そのIDを動画リクエストに渡します。JPEG、PNG、WebPは最大30 MBまで受け付けられ、ほとんどのカメラ画像や商品画像をカバーします。

生成されたクリップはどのくらいの長さにできますか?

▼
tierに応じて5~15秒です。Lite tierは10秒で停止し、MediumとProは15秒に達します。スキルはリクエストを送信する前にGET /v1/modelsから上限を読み取るため、長すぎるdurationは拒否されるのではなく修正されます。

どの解像度が利用可能ですか?

▼
480p、720p、1080p。Lite ティアは720pまでで、Medium と Pro は1080pでレンダリングします。アスペクト比はデフォルトで適応型であり、配信先が既知の場合、エージェントは縦向き、正方形、横向きのフレームを選択できます。

動画のクレジットはどのように課金されますか?

▼
クレジットはジョブの作成時に課金され、失敗した場合は自動的に返還されます。最新の価格マトリクスは GET /v1/models にあり、コストについて質問するとスキルがそれを確認します。キーを作成する前に有料アカウントが必要です。

セッションを閉じるとどうなりますか?

▼
ジョブは当社のサーバー上で実行され続けます。idを指定して GET /v1/generations/{id} を使用するか、GET /v1/generations?limit=20 で最近のジョブを一覧表示してください。署名済みの結果URLは7日間有効なので、急いで取得する必要はありません。

Claude Codeに動画ツールを渡す

キーを作成し、スキルを貼り付けて、最初のクリップをリクエストしてください。APIドキュメントには、すべてのフィールド、ステータス、エラーコードが記載されています。