Stellen und Polling
Beide Erstellungs-Endpunkte geben eine Job-ID zurück. Ein Endpunkt meldet das Ergebnis für beide Medientypen, sodass ein Agent nur ein einziges Abfragemuster benötigt.
curl -sS https://api.dreamutopia.net/v1/generations/$MID \
-H "Authorization: Bearer $DREAMUTOPIA_API_KEY"{
"id": "3f2b…",
"type": "video",
"status": "succeeded",
"model": "medium",
"credits_used": 13,
"created_at": "2026-10-24T12:00:00Z",
"updated_at": "2026-10-24T12:02:10Z",
"result": { "url": "<result_url>" },
"error": null
}Status
| Status | Bedeutung | Terminal |
|---|---|---|
| queued | Akzeptiert, warte auf den Start | Nein |
| processing | Die Generierung läuft | Nein |
| succeeded | result.url ist bereit | Ja |
| failed | error.code ist internal; Credits wurden erstattet | Ja |
queued
- Bedeutung
- Akzeptiert, warte auf den Start
- Terminal
- Nein
processing
- Bedeutung
- Die Generierung läuft
- Terminal
- Nein
succeeded
- Bedeutung
result.urlist bereit- Terminal
- Ja
failed
- Bedeutung
error.codeistinternal; Credits wurden erstattet- Terminal
- Ja
Es gibt kein prozentuales Fortschrittsfeld. Frage `status` ab, bis er endgültig ist.
credits_used ist der Betrag, der beim Erstellen des Jobs berechnet wurde. Ein fehlgeschlagener Job wird automatisch erstattet, aber das Feld meldet weiterhin die ursprüngliche Berechnung; eine kostenlose Chance meldet 0.
Eine Polling-Schleife
MID="3f2b…"
while :; do
BODY=$(curl -sS "https://api.dreamutopia.net/v1/generations/$MID" \
-H "Authorization: Bearer $DREAMUTOPIA_API_KEY")
case "$(jq -r .status <<<"$BODY")" in
succeeded) jq -r .result.url <<<"$BODY"; break ;;
failed) jq -r .error.message <<<"$BODY" >&2; exit 1 ;;
*) sleep 4 ;;
esac
doneBeginne bei 3–5 Sekunden und erhöhe auf 10. Ein typisches Bild dauert 10–40 Sekunden; ein Video kann einige Minuten dauern. Frage nicht häufiger als einmal pro Sekunde ab.
Auflistung und Wiederherstellung
Wenn eine Job-ID verloren geht, listen Sie die letzten Jobs auf. Der Endpunkt ist auf das authentifizierte Konto beschränkt und gibt die neuesten zuerst zurück.
curl -sS "https://api.dreamutopia.net/v1/generations?type=video&limit=20" \
-H "Authorization: Bearer $DREAMUTOPIA_API_KEY"type ist image, video, all oder ausgelassen für beides. limit ist 1–50. Übergeben Sie next_cursor als cursor für die nächste Seite.
Wiederholungsversuche und Idempotenz
Eine Erstellung verbraucht Credits, daher darf ein erneuter Versuch keinen zweiten Job erzeugen. Sende einen Idempotency-Key-Header mit einem eindeutigen Wert pro logischer Anfrage:
curl -sS -X POST https://api.dreamutopia.net/v1/images/generations \
-H "Authorization: Bearer $DREAMUTOPIA_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: my-request-0001" \
-d '{"model":"lite","prompt":"a red fox","resolution":"2k","aspect_ratio":"1:1"}'- Der erste Aufruf gibt
202zurück. - Ein erneuter Versuch mit demselben Schlüssel und Body gibt
200und den bestehenden Job zurück; keine zweite Belastung. - Die Wiederverwendung des Schlüssels mit einem anderen Body oder während der erste Aufruf noch läuft, gibt
409zurück.
Ergebnislaufzeiten
result.url ist eine signierte URL, die sieben Tage lang gültig ist. Lade die Datei herunter und speichere sie, wenn du sie länger benötigst.