🎉 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

Génération d’images

POST /v1/images/generations crée une tâche d'image et retourne immédiatement. Interrogez le point de terminaison de tâche partagé pour obtenir le résultat.

shell
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"
  }'
réponse 202
{ "id": "3f2b…", "type": "image", "status": "queued", "created_at": "2026-10-24T12:00:00Z" }

Champs

  • model

    Valeurs
    lite, pro
  • prompt

    Valeurs
    Obligatoire, non vide, jusqu'à 8 000 caractères
  • resolution

    Valeurs
    2k, 4k ; lite accepte uniquement 2k
  • aspect_ratio

    Valeurs
    1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, adaptive
  • reference_images

    Valeurs
    Téléversez des ids ou des URL DreamUtopia ; 0–3 pour lite, 0–14 pour pro

adaptive nécessite au moins une image de référence. Omettez reference_images pour la génération texte-image. resolution vaut 2k par défaut et aspect_ratio 1:1, donc model + prompt constitue une requête valide.

Références de mélange

Une référence est une image-vers-image ; deux ou plus constituent un mélange multi-références. Téléversez chaque fichier d'abord et transmettez les ids dans l'ordre.

shell
-d '{
    "model": "pro",
    "prompt": "combine the two products on one studio table",
    "resolution": "2k",
    "aspect_ratio": "adaptive",
    "reference_images": ["<upload_id>", "<upload_id>"]
  }'

Coût

Les crédits d'image sont forfaitaires par palier. Les valeurs actuelles figurent dans GET /v1/models sous image[].credits. Les crédits sont débités à la création de la tâche et remboursés en cas d'échec.

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