🎉 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

Generación de imágenes

POST /v1/images/generations crea un trabajo de generación de imágenes y devuelve el control de inmediato. Consulta el endpoint de trabajos compartido para obtener el resultado.

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

Campos

  • model

    Valores
    lite, pro
  • prompt

    Valores
    Obligatorio, no vacío, hasta 8.000 caracteres
  • resolution

    Valores
    2k, 4k; lite solo acepta 2k
  • aspect_ratio

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

    Valores
    Sube ids o URLs de DreamUtopia; 0–3 para lite, 0–14 para pro

adaptive requiere al menos una imagen de referencia. Omite reference_images para texto a imagen. resolution tiene como valor predeterminado 2k y aspect_ratio 1:1, por lo que model + prompt es una solicitud válida.

Referencias de combinación

Una referencia es imagen a imagen; dos o más es una combinación de múltiples referencias. Sube cada archivo primero y pasa los ids en orden.

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

Costo

Los créditos de imagen son fijos por nivel. Los valores vigentes están en GET /v1/models bajo image[].credits. Los créditos se cobran cuando se crea el trabajo y se reembolsan si falla.

© 2026 DreamUtopia. Todos los derechos reservados.