🎉 Gratis-Generierungen beim Erstkauf jedes Pakets — bis zu 20 Lite-Videos + 20 Lite-Bilder + 10 Medium-Videos + 10 Pro-Bilder + 2 Pro-Videos.

Loslegen
DreamUtopia
de

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.

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

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 id ist ein undurchsichtiger Handle. Behandle sie als undurchsichtig; sie funktioniert nur für das Konto, das sie hochgeladen hat.
  • Die signierte url ist sieben Tage lang gültig. Bevorzuge die id: Sie wird bei Verwendung neu signiert.

Verwende den Upload

Übergeben Sie die id im Feld „media“ der Generierung:

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

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.

© 2026 DreamUtopia. Alle Rechte vorbehalten.