Image-Generation & Gallery
Generiere AI-Bilder für Artikel, verwalte Gallery & Trash, editiere bestehende Images.
Die Image-Gallery ist der zentrale Speicher aller AI-generierten Bilder eines Teams. Jedes Bild, das im Chat oder im Artikel-Editor erzeugt wird, landet permanent unter /images — mit Filter, Tags, Favoriten, Soft-Delete und 30-Tage-Papierkorb. Über das Edit-Modal lassen sich Varianten erzeugen (image-to-image via OpenAI gpt-image-2), die als Children am Original hängen. Public-Share-Links machen einzelne Bilder ohne Login teilbar.
Was es kann
- Generate —
POST /v1/generate/imageerzeugt ein neues Bild für einen Prompt. Asynchron, das Ergebnis erscheint in der Gallery. - Gallery & Trash —
GET /v1/imagesmit Filtern (q,model,from,to,favorite,tags[],sort,page).GET /v1/images/trashlistet Soft-Deleted, 30 Tage Aufbewahrung, dann automatischer Hard-Delete. - Edit (Soft-Edit) —
POST /v1/images/{id}/editstartet asynchron eine Variante. Response 202 mit{job_id, edit_session_id}, Frontend pollt/v1/images/{id}und sieht die neue Variante invariants[]. - Metadaten —
PATCH /v1/images/{id}fürtitleundtags[],POST /v1/images/{id}/favoritetoggelt den Stern. - Bulk-Operationen — bulk delete/restore (max 200), bulk export als ZIP (max 500, async via
/v1/images/exports/{job_id}). - Public-Share — idempotenter 40-char-Token, Public-URL ohne Login mit
noindex,nofollow, optionalem Expiry und View-Counter. Audit-Spur bleibt nach Revoke erhalten. - Open-in-Chat —
POST /v1/images/{id}/open-in-chaterstellt eineAiChatSessionmitgallery_image_id, der Agent darf direkt mit dem Bild als Source weiterarbeiten.
Wann nutzen
- Du brauchst Hero-Images, OG-Images oder Inline-Visuals für deine Artikel und willst sie wiederverwendbar archivieren.
- Du willst eine bestehende KI-Visualisierung minimal verändern (Farbe, Detail, Stil) statt komplett neu zu generieren.
- Du willst ein Bild ohne Plattform-Login mit Kunden / Redaktion teilen.
- Du willst Bilder bulk exportieren — z.B. für ein WordPress-Sync oder ein externes DAM.
Workflow
- Generieren —
POST /v1/generate/imagemit{prompt, model?}. Bild landet in der Gallery. - Browsen & Filtern —
GET /v1/images?tags[]=hero&sort=newestlistet matchende Bilder. - Editieren —
POST /v1/images/{id}/editmit Prompt → Variante hängt am Parent. Frontend pollt/v1/images/{id}bisvariants[]gefüllt ist. - Aufräumen —
DELETE /v1/images/{id}schiebt in Trash (30 Tage Restore-Fenster).DELETE /v1/images/{id}/forever(nur aus Trash) löscht endgültig. - Teilen oder weiterverarbeiten —
POST /v1/images/{id}/shareerzeugt einen Public-Link,POST /v1/images/{id}/open-in-chatöffnet eine Chat-Session mit dem Bild als Kontext.
API
| Method | Endpoint | Beschreibung | Credits |
|---|---|---|---|
POST |
/v1/generate/image |
Neues Bild generieren | 5 |
GET |
/v1/images |
Liste mit Filter & Pagination | 0 |
GET |
/v1/images/trash |
Soft-deleted Bilder | 0 |
GET |
/v1/images/{id} |
Detail inkl. variants[] und 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 |
Aus Trash zurückholen | 0 |
DELETE |
/v1/images/{id}/forever |
Hard-delete (nur aus Trash) | 0 |
POST |
/v1/images/bulk/delete · bulk/restore |
Bulk-Operationen, {ids:[]} max 200 |
0 |
POST |
/v1/images/bulk/export |
Async ZIP, max 500 IDs | 0 |
GET |
/v1/images/exports/{job_id} |
Export-Status + download_url |
0 |
POST |
/v1/images/{id}/open-in-chat |
Erstellt AiChatSession mit dem Bild |
0 |
POST/PATCH/DELETE |
/v1/images/{id}/share |
Public-Share verwalten | 0 |
Credits & Limits
- Generate: 5 Credits.
- Edit: 10 Credits (gleicher Tarif wie Generate; OpenAI-Backend-Kosten sind höher beim Edit-Endpoint).
- Bulk-Caps: delete/restore max 200 IDs, export max 500 IDs pro Request.
- Trash-Auto-Prune: 30 Tage, danach hard-delete via Cron.
- PNG-Pflicht für Edits: JPEG/WEBP werden serverseitig in PNG ≤4MB konvertiert.
- Team-scoped: Cross-Team → 404.
Verwandte Module
- AI Content Editor — Bilder aus der Gallery lassen sich direkt in Artikel einfügen.
- Agentic Chat — generierte Bilder erscheinen sofort in der Gallery; Open-in-Chat öffnet eine neue Edit-Session.
- Rankion OS — Bilder können in OS-Ordnern referenziert und freigegeben werden.
Letzte Aktualisierung: 1. Mai 2026