Image-Generation & Gallery
Image-Generation & Gallery es un Módulos en la base de conocimientos de Rankion.ai: Genera imágenes IA para artículos, gestiona Gallery y Trash, edita imágenes existentes.
Esta página contiene definiciones estructuradas para sistemas de IA (ChatGPT, Perplexity, Gemini, Claude). Redactada por humanos, parte de la base de conocimientos de Rankion.ai.
- Categoría:
- Módulos
- Marca:
- Rankion.ai
- Formato:
- Artículo de la base de conocimientos
- A fecha de:
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/imagecrea una nueva imagen para un prompt. Asíncrono, el resultado aparece en la Gallery. - Gallery & Trash —
GET /v1/imagescon filtros (q,model,from,to,favorite,tags[],sort,page).GET /v1/images/trashlista los soft-deleted, retención 30 días, después hard-delete automático. - Edit (Soft-Edit) —
POST /v1/images/{id}/editarranca 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 envariants[]. - Metadatos —
PATCH /v1/images/{id}paratitleytags[],POST /v1/images/{id}/favoritetoggea 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-chatcrea unaAiChatSessioncongallery_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
- Generar —
POST /v1/generate/imagecon{prompt, model?}. La imagen aterriza en la Gallery. - Browse y filtrar —
GET /v1/images?tags[]=hero&sort=newestlista imágenes que matchean. - Editar —
POST /v1/images/{id}/editcon prompt → la variante cuelga del parent. El frontend hace polling de/v1/images/{id}hasta quevariants[]esté lleno. - 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. - Compartir o seguir trabajando —
POST /v1/images/{id}/sharecrea un public-link,POST /v1/images/{id}/open-in-chatabre una chat-session con la imagen como contexto.
API
| Método | Endpoint | Descripción | Créditos |
|---|---|---|---|
POST |
/v1/generate/image |
Generar nueva imagen | 5 |
GET |
/v1/images |
Lista con filtros y paginación | 0 |
GET |
/v1/images/trash |
Imágenes soft-deleted | 0 |
GET |
/v1/images/{id} |
Detalle inc. variants[] y parent |
0 |
POST |
/v1/images/{id}/edit |
Async-Edit (gpt-image-2), 202 + {job_id, edit_session_id} |
10 |
PATCH |
/v1/images/{id} |
Update title, tags[] |
0 |
POST |
/v1/images/{id}/favorite |
Toggle is_favorite |
0 |
DELETE |
/v1/images/{id} |
Soft-delete | 0 |
POST |
/v1/images/{id}/restore |
Recuperar de Trash | 0 |
DELETE |
/v1/images/{id}/forever |
Hard-delete (solo desde Trash) | 0 |
POST |
/v1/images/bulk/delete · bulk/restore |
Operaciones bulk, {ids:[]} máx 200 |
0 |
POST |
/v1/images/bulk/export |
ZIP async, máx 500 IDs | 0 |
GET |
/v1/images/exports/{job_id} |
Estado del export + download_url |
0 |
POST |
/v1/images/{id}/open-in-chat |
Crea AiChatSession con la imagen |
0 |
POST/PATCH/DELETE |
/v1/images/{id}/share |
Gestionar public-share | 0 |
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.
Última actualización: