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

今すぐ始める
DreamUtopia
ja

アップロード

生成は、任意の画像入力に対してアップロードIDを受け付けます。一度アップロードすれば、そのIDが存在する間は必要なだけ何度でもリクエストで再利用できます。

shell
curl -sS -X POST https://api.dreamutopia.net/v1/uploads \
  -H "Authorization: Bearer $DREAMUTOPIA_API_KEY" \
  -F "file=@/path/to/photo.png"
response 201
{
  "id": "<upload_id>",
  "url": "<upload_url>",
  "expires_at": "2026-10-31T12:00:00Z"
}

ルール

  • file という名前のマルチパートパートが1つあります。
  • JPEG、PNG、WebP のいずれであるかは、パートの Content-Type ではなくファイルのバイト列によって判定します。
  • 最大30 MB。より大きなリクエストは、オブジェクトが保存される前に拒否されます。
  • 返されたidは不透明なハンドルです。不透明なものとして扱ってください。これはアップロードしたアカウントでのみ機能します。
  • 署名済みのurlは7日間有効です。idを優先してください。使用時に再署名されます。

アップロードを使用する

生成のmediaフィールドにidを渡します:

image → image
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":"the same scene in watercolor","resolution":"2k","aspect_ratio":"adaptive","reference_images":["<upload_id>"]}'
画像 → 動画
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":"a gentle camera push","image":"<upload_id>","resolution":"720p","duration":8}'

連鎖とクリーンアップ

完成した生成物の result.url は、アップロード ID を受け付けるあらゆる場所で使用できるため、あるジョブの出力を次のジョブの入力にできます。画像参照には外部 URL は使用できません。どの生成物からも参照されていないアップロード済みオブジェクトは保持期間の経過後に削除されますが、使用済みのオブジェクトはその生成物が存在する限り保持されます。

© 2026 DreamUtopia. 全著作権所有。