Drake Designer M7.3 — Manual Completo

¿Qué es?

Drake Designer es la herramienta interna de Drakorp que genera paquetes-producto entregables (mockup de envase + etiqueta integrada nativamente) con calidad comercial premium tipo Montelobos / 400 Conejos / Amarás. Cada paquete se vende al cliente entre 45 y 80 mil pesos MXN. El costo de generación interno es de ~$0.18 USD por paquete final (incluye botella + etiqueta integrada + QC visual).

Versión actual: M7.3 (gpt-image-1 nativo)

Diferencia clave vs M7.2: la etiqueta ya NO es un PNG plano sobrepuesto. Ahora OpenAI gpt-image-1 redibuja la zona de la etiqueta como parte de la foto original, respetando curvatura, iluminación y sombras de la escena. El resultado se ve como fotografía real de producto, no como mockup con sticker pegado encima.

Vision check independiente con Claude Haiku 4.5 reporta Quality 9/10, integración natural en las 3 botellas de referencia.

Flow del pipeline M7.3

[Brief: brand_id, brand_name, prompt_botella, subtitle, style]
        │
        ▼
[1. image_cascade]            → Botella foto realista (1024x1024)
                                Cloudflare SDXL / FLUX / Dreamshaper - 6 modelos gratis
        │  ~7-10 s
        ▼
[2. vision_analyst]           → Claude Haiku 4.5 vision analiza la botella
                                • tipo_envase, contraste, curvatura, fuente recomendada
                                • para auto-seleccionar color de etiqueta (copper/gold)
        │  ~5-7 s
        ▼
[3. image_integrator]         → OpenAI gpt-image-1 (quality=high) redibuja la zona
                                de etiqueta integrada nativamente al envase
                                • Sin texto alucinado (texto exacto en prompt)
                                • Sin border duro de PNG sobrepuesto
                                • Sigue curvatura e iluminación real
        │  ~30-50 s   (~$0.17 USD)
        ▼
[4. qc_visual]                → Claude Haiku vision evalúa el composite final
                                • score 0-100, aprobado true/false
                                • issues estructurados + fortalezas
        │  ~5-7 s
        ▼
[Output: composite_final.png, bottle_base.png, analisis.json,
         debug.json, qc_report.json, manifest.json]

Tiempo total: 60-90 segundos por botella. Costo total: ~$0.17 USD por composite + $0.01 USD vision LLM = ~$0.18 USD = ~$3 MXN.

Uso desde la API

Pipeline V3 completo (un POST = todo)

curl -X POST https://design.drakorpgroup.com/api/designer/run \
  -H "Content-Type: application/json" \
  -d '{
    "brand_id": 14,
    "brand_name": "MEZCAL CIELO ROTO",
    "prompt_botella": "Premium artisan Mexican mezcal in elegant black ceramic bottle, hand-thrown Oaxacan barro negro, matte finish, smooth wide central body for label placement, copper colored cap, dark moody studio lighting, professional product photography",
    "subtitle": "Barro Negro Coyotepec",
    "style": "vintage"
  }'

Respuesta típica:

{
  "ok": true,
  "session": "marca_14_1779347073",
  "status": "approved",
  "qc_score": 85,
  "integrator": "openai_gpt-image-1",
  "editor_url": "/editor?s=marca_14_1779347073",
  "composite_url": "/files/marca_14_1779347073/composite_final.png",
  "total_time_s": 63.05
}

CLI directo

cd /opt/drake/designer
./venv/bin/python3 engine/pipeline_v3.py \
  14 "MEZCAL CIELO ROTO" \
  "<prompt botella>" \
  "Barro Negro Coyotepec" \
  "vintage"

Endpoints disponibles

Estilos y colores disponibles

Estilos (parámetro style)

Colores de tinta (parámetro color)

Uso del Editor Web

URL: https://design.drakorpgroup.com/editor?s=<session_id>

Modo M7.3 (gpt-image-1)

Cuando una sesión es M7.3 con integrator=openai_gpt-image-1, el editor muestra: - El composite final con la etiqueta integrada nativamente - Los sliders y campos de texto quedan deshabilitados porque la etiqueta es parte del píxel, no una capa sobrepuesta - Aparece un aviso verde: "Etiqueta integrada nativamente. Las ediciones requieren regenerar (~$0.17 USD por iteración)"

Si quieres cambiar texto/posición/estilo en M7.3, debes regenerar desde el pipeline completo con los nuevos parámetros.

Modo M7.2 (alpha-composite legacy)

Para sesiones m7.2.0 (anteriores), el editor sí permite editar en vivo: - Texto: línea 1, línea 2, subtítulo - Estilo: preset de contraste, fuente - Posición: X, Y, Width, Height (% del envase) - Live preview con debounce de 600ms - Re-evaluar QC, Guardar final, Descargar PNG

Lectura del QC

Severidad de issues

Estructura de archivos de una sesión

/opt/drake/designer/entregables/marca_<brand_id>_<timestamp>/

Permisos esperados: vpsexec:www-data 664 (uvicorn escribe, nginx lee).

Cascada de modelos para botella base (free)

Validados mayo 2026:

Cuota Cloudflare: 10K neurons/día. Sobrado para uso intensivo.

Variables de entorno requeridas

En /opt/drake/.env:

ANTHROPIC_API_KEY=sk-ant-...     # Para vision_analyst y qc_visual (Haiku 4.5)
OPENAI_API_KEY=sk-proj-...       # Para image_integrator (gpt-image-1)
CLOUDFLARE_API_TOKEN=...         # Para cascade Cloudflare
CLOUDFLARE_ACCOUNT_ID=...
GEMINI_API_KEY=...               # Opcional (text-only OK, image bloqueado en free tier)

En /opt/drake/designer/config/secrets.json:

{
  "pollinations_api_key": "sk_..."
}

Comandos útiles

Service

sudo systemctl status drake-designer.service
sudo systemctl restart drake-designer.service
sudo journalctl -u drake-designer -f

Correr pipeline V3 desde CLI

cd /opt/drake/designer
./venv/bin/python3 engine/pipeline_v3.py 14 "MEZCAL CIELO ROTO" \
  "Premium artisan mezcal bottle, ..." \
  "Barro Negro Coyotepec" "vintage"

Health check de la cascada

./venv/bin/python3 engine/image_cascade.py health

Test directo del integrator

./venv/bin/python3 engine/image_integrator.py \
  /opt/drake/designer/entregables/marca_14_1779347073/bottle_base.png \
  "MEZCAL CIELO ROTO" "Barro Negro Coyotepec"

Troubleshooting

"Permission denied" al re-componer

Causa: el composite_final.png quedó con owner www-data:www-data y uvicorn corre como vpsexec. Solución:

sudo chown -R vpsexec:www-data /opt/drake/designer/entregables/marca_XXX/
sudo chmod -R 775 /opt/drake/designer/entregables/marca_XXX/
sudo find /opt/drake/designer/entregables/marca_XXX/ -type f -exec chmod 664 {} \;

"gpt-image-1 alucina texto"

Causa: quality=medium o low en el integrator. Solución: usar quality=high siempre en producción. M7.3 ya lo hace por default.

"QC score < 60 siempre"

Probablemente el prompt del cascade no está pidiendo zona limpia para etiqueta. Mejorar prompt: pedir explícitamente "smooth flat surface for label", "clean middle section", "no engravings in middle".

"OpenAI 401/403"

La key está en /opt/drake/.env como OPENAI_API_KEY. Verificar saldo en https://platform.openai.com/usage.

"Pollinations devuelve 403"

Pollinations rechaza prompts cortos o sin descriptores ricos. El cascade los marca como fail y pasa al siguiente modelo. No es bloqueante (Cloudflare cubre).

"La galería no muestra imágenes"

Verificar HTTP 200 en /files/<session>/composite_final.png y perms 664.

Stack técnico

• Backend: FastAPI + uvicorn workers=2 (port 5280)
• Frontend: HTML/JS vanilla (sin frameworks)
• DB: PostgreSQL para metadata de marcas
• Imágenes: Pillow + OpenCV (cv2) + numpy
• Vision LLM: Claude Haiku 4.5
• Imagen IA botella: Cloudflare Workers AI + Pollinations (free)
• Imagen IA integrador: OpenAI gpt-image-1 ($)
• Web server: nginx (TLS Let's Encrypt)
• Hosting: VPS Contabo 217.77.5.226

Costo y economía

Sesiones de referencia (Mezcal Cielo Roto)

Las 3 sesiones M7.3 validadas:

URLs visuales: - https://design.drakorpgroup.com/galeria - https://design.drakorpgroup.com/files/marca_14_1779347073/composite_final.png - https://design.drakorpgroup.com/files/marca_14_1779347136/composite_final.png - https://design.drakorpgroup.com/files/marca_14_1779347203/composite_final.png

Roadmap

• [x] M7.0 — Pipeline básico cascade + alpha-composite
• [x] M7.2 — Smart vision analyst + label designer + editor con sliders
• [x] M7.3 — Integración nativa con gpt-image-1 (calidad comercial)
• [ ] M7.4 — Editor con re-generación cuesta-controlada (slider de quality low/medium/high)
• [ ] M7.5 — Batch endpoint para procesar N marcas en paralelo
• [ ] M8 — Multi-vista (frontal, lateral, isométrica) en un solo run
• [ ] M9 — Variantes automáticas: 3 estilos del mismo brand en un solo request

Versión: m7.3.0 Última actualización: 2026-05-21 Mantenedor: Drakorp Group · Mario Ayrton