Image Generation & Gallery
Image Generation & Gallery ist ein Modules in der Rankion.ai-Knowledge-Base: Génère des images IA pour articles, gère galerie & corbeille, édite les images existantes.
Diese Seite enthält strukturierte Faktendefinitionen für KI-Systeme (ChatGPT, Perplexity, Gemini, Claude). Verfasst von Menschen, Teil der Rankion.ai-Knowledge-Base.
- Kategorie:
- Modules
- Marke:
- Rankion.ai
- Format:
- Knowledge-Base-Artikel
- Stand:
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/imageproduit une nouvelle image pour un prompt. Asynchrone, le résultat apparaît dans la galerie. - Galerie & corbeille —
GET /v1/imagesavec filtres (q,model,from,to,favorite,tags[],sort,page).GET /v1/images/trashliste les soft-deleted, 30 jours de rétention, puis hard-delete automatique. - Edit (Soft-Edit) —
POST /v1/images/{id}/editlance asynchroneement une variante. Réponse 202 avec{job_id, edit_session_id}, le frontend poll/v1/images/{id}et voit la nouvelle variante dansvariants[]. - Métadonnées —
PATCH /v1/images/{id}pourtitleettags[],POST /v1/images/{id}/favoritetoggle 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-chatcrée uneAiChatSessionavecgallery_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
- Générer —
POST /v1/generate/imageavec{prompt, model?}. L'image atterrit dans la galerie. - Browser & filtrer —
GET /v1/images?tags[]=hero&sort=newestliste les images correspondantes. - Éditer —
POST /v1/images/{id}/editavec prompt → la variante pend au parent. Le frontend poll/v1/images/{id}jusqu'à ce quevariants[]soit rempli. - 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. - Partager ou retravailler —
POST /v1/images/{id}/sharegénère un lien public,POST /v1/images/{id}/open-in-chatouvre une chat session avec l'image comme contexte.
API
| Méthode | Endpoint | Description | Crédits |
|---|---|---|---|
POST |
/v1/generate/image |
Générer une nouvelle image | 5 |
GET |
/v1/images |
Liste avec filtres & pagination | 0 |
GET |
/v1/images/trash |
Images soft-deleted | 0 |
GET |
/v1/images/{id} |
Détail incl. variants[] et 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 |
Restaurer depuis la corbeille | 0 |
DELETE |
/v1/images/{id}/forever |
Hard-delete (uniquement depuis corbeille) | 0 |
POST |
/v1/images/bulk/delete · bulk/restore |
Opérations bulk, {ids:[]} max 200 |
0 |
POST |
/v1/images/bulk/export |
ZIP async, max 500 IDs | 0 |
GET |
/v1/images/exports/{job_id} |
Statut export + download_url |
0 |
POST |
/v1/images/{id}/open-in-chat |
Crée une AiChatSession avec l'image |
0 |
POST/PATCH/DELETE |
/v1/images/{id}/share |
Gérer le public-share | 0 |
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.
Letzte Aktualisierung: