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.
curl -sS -X POST https://api.dreamutopia.net/v1/uploads \
-H "Authorization: Bearer $DREAMUTOPIA_API_KEY" \
-F "file=@/path/to/photo.png"{
"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
idis an opaque handle. Treat it as opaque; it only works for the account that uploaded it. - The signed
urlis valid for seven days. Prefer theid: it is re-signed when used.
Use the upload
Pass the id in the media field of the generation:
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}'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.