Emplois et interrogation
Les deux points de terminaison de création renvoient un identifiant de tâche. Un seul point de terminaison signale le résultat pour l'un ou l'autre type de média, de sorte qu'un agent n'a besoin que d'un seul modèle d'interrogation.
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
}Statuts
| statut | Signification | Terminal |
|---|---|---|
| queued | Accepté, en attente de démarrage | Non |
| processing | La génération est en cours | Non |
| succeeded | result.url est prêt | Oui |
| failed | error.code est internal ; les crédits ont été remboursés | Oui |
queued
- Signification
- Accepté, en attente de démarrage
- Terminal
- Non
processing
- Signification
- La génération est en cours
- Terminal
- Non
succeeded
- Signification
result.urlest prêt- Terminal
- Oui
failed
- Signification
error.codeestinternal; les crédits ont été remboursés- Terminal
- Oui
Il n'y a pas de champ de progression en pourcentage. Interrogez `status` jusqu'à ce qu'il soit définitif.
credits_used correspond au montant facturé lors de la création de la tâche. Une tâche échouée est remboursée automatiquement, mais le champ indique toujours le montant initial ; une opportunité gratuite indique 0.
Une boucle de sondage
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
doneCommencez à 3–5 secondes et espacez jusqu'à 10. Une image typique prend 10–40 secondes ; une vidéo peut prendre quelques minutes. Ne sondez pas plus d'une fois par seconde.
Inscription et récupération
Si un ID de tâche est perdu, listez les tâches récentes. Le point de terminaison est limité au compte authentifié et renvoie les plus récentes en premier.
curl -sS "https://api.dreamutopia.net/v1/generations?type=video&limit=20" \
-H "Authorization: Bearer $DREAMUTOPIA_API_KEY"type est image, video, all, ou omis pour les deux. limit est 1–50. Repassez next_cursor en tant que cursor pour la page suivante.
Tentatives et idempotence
Une création consomme des crédits, donc une nouvelle tentative ne doit pas créer une seconde tâche. Envoyez un en-tête Idempotency-Key avec une valeur unique par requête logique :
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"}'- Le premier appel renvoie
202. - Une nouvelle tentative avec la même clé et le même corps renvoie
200et la tâche existante ; pas de second débit. - Réutiliser la clé avec un corps différent, ou pendant que le premier appel est encore en cours, renvoie
409.
Durées de vie des résultats
result.url est une URL signée valable sept jours. Téléchargez et stockez le fichier si vous en avez besoin plus longtemps.