Bildgenerierung
POST /v1/images/generations erstellt einen Bildauftrag und kehrt sofort zurück. Rufen Sie den gemeinsamen Job-Endpunkt ab, um das Ergebnis zu erhalten.
curl -sS -X POST https://api.dreamutopia.net/v1/images/generations \
-H "Authorization: Bearer $DREAMUTOPIA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "pro",
"prompt": "a red fox in fresh snow, cinematic lighting",
"resolution": "2k",
"aspect_ratio": "16:9"
}'{ "id": "3f2b…", "type": "image", "status": "queued", "created_at": "2026-10-24T12:00:00Z" }Fields
| Feld | Werte |
|---|---|
| model | lite, pro |
| prompt | Erforderlich, nicht leer, bis zu 8.000 Zeichen |
| resolution | 2k, 4k; lite akzeptiert nur 2k |
| aspect_ratio | 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, adaptive |
| reference_images | Lade ids oder DreamUtopia-URLs hoch; 0–3 für lite, 0–14 für pro |
model
- Werte
lite,pro
prompt
- Werte
- Erforderlich, nicht leer, bis zu 8.000 Zeichen
resolution
- Werte
2k,4k;liteakzeptiert nur2k
aspect_ratio
- Werte
1:1,4:3,3:4,16:9,9:16,3:2,2:3,adaptive
reference_images
- Werte
- Lade ids oder DreamUtopia-URLs hoch; 0–3 für
lite, 0–14 fürpro
adaptive erfordert mindestens ein Referenzbild. Für Text-zu-Bild reference_images weglassen. resolution ist standardmäßig 2k und aspect_ratio 1:1, daher ist model + prompt eine gültige Anfrage.
Referenzen kombinieren
Eine Referenz ist Image-to-Image; zwei oder mehr sind ein Multi-Referenz-Blend. Lade zuerst jede Datei hoch und übergib die IDs in der Reihenfolge.
-d '{
"model": "pro",
"prompt": "combine the two products on one studio table",
"resolution": "2k",
"aspect_ratio": "adaptive",
"reference_images": ["<upload_id>", "<upload_id>"]
}'Kosten
Bildguthaben sind pauschal pro Stufe. Die aktuellen Werte stehen in GET /v1/models unter image[].credits. Guthaben werden bei der Erstellung des Jobs abgebucht und bei einem Fehlschlag zurückerstattet.