🎉 Free generations on your first purchase of each pack — up to 20 Lite videos + 20 Lite images + 10 Medium videos + 10 Pro images + 2 Pro videos.

Get started

Uploads

A generation accepts an upload id for any image input. Upload once, then reuse the id in as many requests as you need while it exists.

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"
}

Rules

  • One multipart part named file.
  • JPEG, PNG or WebP, decided by the file bytes — not by the part's Content-Type.
  • Maximum 30 MB. Larger requests are refused before the object is stored.
  • The returned id is an opaque handle. Treat it as opaque; it only works for the account that uploaded it.
  • The signed url is valid for seven days. Prefer the id: it is re-signed when used.

Use the upload

Pass the id in the media field of the generation:

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>"]}'
image → video
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}'

Chaining and cleanup

A finished generation's result.url can be used anywhere an upload id is accepted, so one job can feed the next. External URLs are not accepted for image references. An uploaded object that no generation references is removed after the retention window; a used one is kept for as long as its generation exists.

© 2026 DreamUtopia. All rights reserved.