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.
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"
}'{ "id": "3f2b…", "type": "image", "status": "queued", "created_at": "2026-10-24T12:00:00Z" }Champs
| Champ | Valeurs |
|---|---|
| model | lite, pro |
| prompt | Obligatoire, non vide, jusqu'à 8 000 caractères |
| resolution | 2k, 4k ; lite accepte uniquement 2k |
| aspect_ratio | 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, adaptive |
| reference_images | Téléversez des ids ou des URL DreamUtopia ; 0–3 pour lite, 0–14 pour pro |
model
- Valeurs
lite,pro
prompt
- Valeurs
- Obligatoire, non vide, jusqu'à 8 000 caractères
resolution
- Valeurs
2k,4k;liteaccepte uniquement2k
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 pourpro
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.
-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.