🎉 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

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.

shell
curl -sS https://api.dreamutopia.net/v1/generations/$MID \
  -H "Authorization: Bearer $DREAMUTOPIA_API_KEY"
Antwort
{
  "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

  • queued

    Bedeutung
    Akzeptiert, warte auf den Start
    Terminal
    Nein
  • processing

    Bedeutung
    Die Generierung läuft
    Terminal
    Nein
  • succeeded

    Bedeutung
    result.url ist bereit
    Terminal
    Ja
  • failed

    Bedeutung
    error.code ist internal; 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

bash
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
done

Beginne 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.

shell
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:

shell
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 202 zurück.
  • Ein erneuter Versuch mit demselben Schlüssel und Body gibt 200 und 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 409 zurü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.

© 2026 DreamUtopia. Alle Rechte vorbehalten.