Cargas
Una generación acepta un id de carga para cualquier entrada de imagen. Carga una vez y luego reutiliza el id en tantas solicitudes como necesites mientras exista.
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"
}Reglas
- Una parte multiparte llamada
file. - JPEG, PNG o WebP, decidido por los bytes del archivo — no por el Content-Type de la parte.
- Máximo 30 MB. Las solicitudes más grandes se rechazan antes de que se almacene el objeto.
- El
iddevuelto es un identificador opaco. Trátalo como opaco; solo funciona para la cuenta que lo subió. - La
urlfirmada es válida durante siete días. Se prefiere elid: se vuelve a firmar cuando se usa.
Usa la carga
Pasa el id en el campo media de la generación:
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}'Encadenamiento y limpieza
La result.url de una generación finalizada se puede usar en cualquier lugar donde se acepte un id de carga, así que un trabajo puede alimentar al siguiente. No se aceptan URL externas para referencias de imágenes. Un objeto cargado que ninguna generación referencia se elimina después del periodo de retención; uno usado se conserva mientras exista su generación.