🎉 Generaciones gratis en la primera compra de cada pack — hasta 20 videos Lite + 20 imágenes Lite + 10 videos Medium + 10 imágenes Pro + 2 videos Pro.

Empezar
DreamUtopia
es

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.

shell
curl -sS -X POST https://api.dreamutopia.net/v1/uploads \
  -H "Authorization: Bearer $DREAMUTOPIA_API_KEY" \
  -F "file=@/path/to/photo.png"
respuesta 201
{
  "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 id devuelto es un identificador opaco. Trátalo como opaco; solo funciona para la cuenta que lo subió.
  • La url firmada es válida durante siete días. Se prefiere el id: se vuelve a firmar cuando se usa.

Usa la carga

Pasa el id en el campo media de la generación:

imagen → imagen
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>"]}'
imagen → vídeo
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.

© 2026 DreamUtopia. Todos los derechos reservados.