Uploads
Eine Generierung akzeptiert eine Upload-ID für jede Bildeingabe. Lade einmal hoch und verwende die ID dann in beliebig vielen Anfragen wieder, solange sie existiert.
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"
}Regeln
- Ein Multipart-Teil namens
file. - JPEG, PNG oder WebP, entschieden anhand der Dateibytes — nicht anhand des Content-Type des Teils.
- Maximal 30 MB. Größere Anfragen werden abgelehnt, bevor das Objekt gespeichert wird.
- Die zurückgegebene
idist ein undurchsichtiger Handle. Behandle sie als undurchsichtig; sie funktioniert nur für das Konto, das sie hochgeladen hat. - Die signierte
urlist sieben Tage lang gültig. Bevorzuge dieid: Sie wird bei Verwendung neu signiert.
Verwende den Upload
Übergeben Sie die id im Feld „media“ der Generierung:
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}'Verkettung und Bereinigung
Die result.url einer abgeschlossenen Generierung kann überall dort verwendet werden, wo eine Upload-ID akzeptiert wird, sodass ein Auftrag den nächsten speisen kann. Externe URLs werden für Bildreferenzen nicht akzeptiert. Ein hochgeladenes Objekt, auf das keine Generierung verweist, wird nach Ablauf des Aufbewahrungszeitraums entfernt; ein verwendetes wird so lange aufbewahrt, wie seine Generierung existiert.