Téléversements
Une génération accepte un id de téléversement pour toute entrée d’image. Téléversez une fois, puis réutilisez l’id dans autant de requêtes que nécessaire tant qu’il existe.
curl -sS -X POST https://api.dreamutopia.net/v1/uploads \
-H "Authorization: Bearer $DREAMUTOPIA_API_KEY" \
-F "file=@/path/to/photo.png"{
"id": "<upload_id>",
"url": "<upload_url>",
"expires_at": "2026-10-31T12:00:00Z"
}Règles
- Une partie multipart nommée
file. - JPEG, PNG ou WebP, déterminé par les octets du fichier — pas par le Content-Type de la partie.
- 30 Mo maximum. Les requêtes plus volumineuses sont refusées avant que l'objet ne soit stocké.
- L'
idrenvoyé est un identifiant opaque. Traitez-le comme opaque ; il ne fonctionne que pour le compte qui l'a téléversé. - L’
urlsignée est valable sept jours. Préférez l’id: elle est re-signée lors de son utilisation.
Utilisez le téléchargement
Transmettez l'id dans le champ media de la génération :
curl -sS -X POST https://api.dreamutopia.net/v1/images/generations \
-H "Authorization: Bearer $DREAMUTOPIA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"lite","prompt":"the same scene in watercolor","resolution":"2k","aspect_ratio":"adaptive","reference_images":["<upload_id>"]}'curl -sS -X POST https://api.dreamutopia.net/v1/videos/generations \
-H "Authorization: Bearer $DREAMUTOPIA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"medium","prompt":"a gentle camera push","image":"<upload_id>","resolution":"720p","duration":8}'Chaînage et nettoyage
L'result.url d'une génération terminée peut être utilisé partout où un identifiant de téléversement est accepté, ainsi une tâche peut alimenter la suivante. Les URL externes ne sont pas acceptées pour les références d'images. Un objet téléversé qu'aucune génération ne référence est supprimé après la fenêtre de rétention ; un objet utilisé est conservé aussi longtemps que sa génération existe.