Image-Generation & Gallery

La Image-Gallery es el almacén central de todas las imágenes generadas por IA de un team. Cada imagen creada en el chat o en el editor de artículos aterriza permanentemente en /images — con filtro, tags, favoritos, soft-delete y papelera de 30 días. Mediante el modal de edición se generan variantes (image-to-image vía OpenAI gpt-image-2) que cuelgan como children del original. Los public-share-links permiten compartir imágenes sin login.

Qué puede hacer

• Generate — POST /v1/generate/image crea una nueva imagen para un prompt. Asíncrono, el resultado aparece en la Gallery.
• Gallery & Trash — GET /v1/images con filtros (q, model, from, to, favorite, tags[], sort, page). GET /v1/images/trash lista los soft-deleted, retención 30 días, después hard-delete automático.
• Edit (Soft-Edit) — POST /v1/images/{id}/edit arranca asíncronamente una variante. Response 202 con {job_id, edit_session_id}, el frontend hace polling de /v1/images/{id} y ve la nueva variante en variants[].
• Metadatos — PATCH /v1/images/{id} para title y tags[], POST /v1/images/{id}/favorite toggea la estrella.
• Operaciones bulk — bulk delete/restore (máx 200), bulk export como ZIP (máx 500, async vía /v1/images/exports/{job_id}).
• Public-Share — token idempotente de 40 chars, URL pública sin login con noindex,nofollow, expiry opcional y view-counter. El audit trail se conserva tras un revoke.
• Open-in-Chat — POST /v1/images/{id}/open-in-chat crea una AiChatSession con gallery_image_id, el agente puede seguir trabajando con la imagen como source.

Cuándo usarlo

• Necesitas hero-images, OG-images o visuals inline para tus artículos y quieres archivarlos para reuso.
• Quieres modificar mínimamente una visualización IA existente (color, detalle, estilo) en lugar de regenerarla por completo.
• Quieres compartir una imagen sin login de la plataforma con clientes / redacción.
• Quieres exportar imágenes en bulk — p.ej. para un sync con WordPress o un DAM externo.

Workflow

1. Generar — POST /v1/generate/image con {prompt, model?}. La imagen aterriza en la Gallery.
2. Browse y filtrar — GET /v1/images?tags[]=hero&sort=newest lista imágenes que matchean.
3. Editar — POST /v1/images/{id}/edit con prompt → la variante cuelga del parent. El frontend hace polling de /v1/images/{id} hasta que variants[] esté lleno.
4. Limpiar — DELETE /v1/images/{id} la mueve a Trash (ventana de restore de 30 días). DELETE /v1/images/{id}/forever (solo desde Trash) la borra definitivamente.
5. Compartir o seguir trabajando — POST /v1/images/{id}/share crea un public-link, POST /v1/images/{id}/open-in-chat abre una chat-session con la imagen como contexto.

API

Créditos y límites

• Generate: 5 créditos.
• Edit: 10 créditos (mismo precio que Generate; los costes de backend OpenAI son más altos en el endpoint Edit).
• Caps bulk: delete/restore máx 200 IDs, export máx 500 IDs por request.
• Auto-prune del Trash: 30 días, después hard-delete vía cron.
• PNG obligatorio para edits: JPEG/WEBP se convierten en el servidor a PNG ≤4MB.
• Team-scoped: cross-team → 404.

Módulos relacionados

• AI Content Editor — las imágenes de la Gallery se insertan directamente en artículos.
• Agentic Chat — las imágenes generadas aparecen al instante en la Gallery; Open-in-Chat abre una nueva edit-session.
• Rankion OS — las imágenes pueden referenciarse y compartirse en carpetas del OS.