Image Generation & Gallery

L'Image Gallery est le stockage central de toutes les images IA générées d'une équipe. Chaque image produite dans le chat ou dans l'éditeur d'article atterrit de manière permanente sous /images — avec filtres, tags, favoris, soft-delete et corbeille de 30 jours. Via la modale d'édition, des variantes peuvent être créées (image-to-image via OpenAI gpt-image-2), qui pendent comme children sur l'original. Les liens public-share rendent les images individuellement partageables sans login.

Ce qu'il peut faire

• Generate — POST /v1/generate/image produit une nouvelle image pour un prompt. Asynchrone, le résultat apparaît dans la galerie.
• Galerie & corbeille — GET /v1/images avec filtres (q, model, from, to, favorite, tags[], sort, page). GET /v1/images/trash liste les soft-deleted, 30 jours de rétention, puis hard-delete automatique.
• Edit (Soft-Edit) — POST /v1/images/{id}/edit lance asynchroneement une variante. Réponse 202 avec {job_id, edit_session_id}, le frontend poll /v1/images/{id} et voit la nouvelle variante dans variants[].
• Métadonnées — PATCH /v1/images/{id} pour title et tags[], POST /v1/images/{id}/favorite toggle l'étoile.
• Opérations bulk — bulk delete/restore (max 200), bulk export en ZIP (max 500, async via /v1/images/exports/{job_id}).
• Public-Share — token idempotent de 40 caractères, URL publique sans login avec noindex,nofollow, expiry optionnel et compteur de vues. La trace d'audit reste après revoke.
• Open-in-Chat — POST /v1/images/{id}/open-in-chat crée une AiChatSession avec gallery_image_id, l'agent peut continuer à travailler directement avec l'image comme source.

Quand l'utiliser

• Tu as besoin de hero images, OG images ou visuels inline pour tes articles et tu veux les archiver de manière réutilisable.
• Tu veux modifier minimalement une visualisation IA existante (couleur, détail, style) plutôt que regénérer entièrement.
• Tu veux partager une image sans login plateforme avec des clients / la rédaction.
• Tu veux exporter des images en bulk — par ex. pour un sync WordPress ou un DAM externe.

Workflow

1. Générer — POST /v1/generate/image avec {prompt, model?}. L'image atterrit dans la galerie.
2. Browser & filtrer — GET /v1/images?tags[]=hero&sort=newest liste les images correspondantes.
3. Éditer — POST /v1/images/{id}/edit avec prompt → la variante pend au parent. Le frontend poll /v1/images/{id} jusqu'à ce que variants[] soit rempli.
4. Ranger — DELETE /v1/images/{id} pousse en corbeille (fenêtre de restore de 30 jours). DELETE /v1/images/{id}/forever (uniquement depuis la corbeille) supprime définitivement.
5. Partager ou retravailler — POST /v1/images/{id}/share génère un lien public, POST /v1/images/{id}/open-in-chat ouvre une chat session avec l'image comme contexte.

API

Crédits et limites

• Generate : 5 crédits.
• Edit : 10 crédits (même tarif que Generate ; les coûts backend OpenAI sont plus élevés sur l'endpoint Edit).
• Caps bulk : delete/restore max 200 IDs, export max 500 IDs par requête.
• Auto-prune corbeille : 30 jours, ensuite hard-delete via cron.
• Obligation PNG pour les edits : JPEG/WEBP sont convertis côté serveur en PNG ≤4 MB.
• Team-scoped : cross-team → 404.

Modules associés

• AI Content Editor — les images de la galerie peuvent être insérées directement dans les articles.
• Agentic Chat — les images générées apparaissent immédiatement dans la galerie ; Open-in-Chat ouvre une nouvelle session d'édition.
• Rankion OS — les images peuvent être référencées et partagées dans les dossiers OS.