🎉 Générations offertes au premier achat de chaque pack — jusqu'à 20 vidéos Lite + 20 images Lite + 10 vidéos Medium + 10 images Pro + 2 vidéos Pro.

Commencer
DreamUtopia
fr

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.

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

  • queued

    Signification
    Accepté, en attente de démarrage
    Terminal
    Non
  • processing

    Signification
    La génération est en cours
    Terminal
    Non
  • succeeded

    Signification
    result.url est prêt
    Terminal
    Oui
  • failed

    Signification
    error.code est internal ; 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

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

Commencez à 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.

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

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"}'
  • Le premier appel renvoie 202.
  • Une nouvelle tentative avec la même clé et le même corps renvoie 200 et 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.

© 2026 DreamUtopia. Tous droits réservés.