Afbeeldingen genereren & bewerken

LibreChat wordt geleverd met ingebouwde afbeeldingshulpmiddelen die je kunt toevoegen aan een Agent. Elk hulpmiddel heeft zijn eigen model, prijsniveau en configuratie, meestal alleen een API-sleutel of een URL. Er is geen aparte afbeeldingspagina: je genereert of bewerkt afbeeldingen door te chatten met een Agent waarvoor een afbeeldingshulpmiddel is ingeschakeld.

Quick Start

Laat beeldgeneratie binnen enkele minuten werken met OpenAI Image Tools.

IMAGE_GEN_OAI_API_KEY=sk-your-openai-api-key
# Optional; defaults to gpt-image-1
IMAGE_GEN_OAI_MODEL=gpt-image-1

OpenAI Image Tools

"OpenAI Image Tools" is een agent-toolkit die bestaat uit twee afzonderlijke tools:

• Image Generation maakt gloednieuwe afbeeldingen op basis van tekstprompts (geen upload vereist).
• Image Editing bewerkt of remixt afbeeldingen die je hebt geüpload: verander kleuren, voeg objecten toe, vergroot het canvas en meer.

Beide gebruiken standaard GPT-Image-1 voor het opvolgen van instructies, tekstweergave, gedetailleerde bewerking en kennis van de echte wereld. Gebruik IMAGE_GEN_OAI_MODEL om een ander OpenAI-afbeeldingsmodel te kiezen wanneer je implementatie dit ondersteunt. Zie de documentatie over afbeeldingsgeneratie van OpenAI voor meer details.

Generatie vs. Bewerken

Beide tools zijn altijd beschikbaar en de agent kiest de juiste op basis van het verzoek:

• Image Generation maakt nieuwe afbeeldingen op basis van alleen tekstbeschrijvingen.
• Afbeeldingsbewerking wijzigt of remixt bestaande afbeeldingen met behulp van hun afbeeldings-ID's. Dit kunnen afbeeldingen uit het huidige bericht zijn of eerder gegenereerde en gerefereerde afbeeldingen. De LLM houdt de afbeeldings-ID's bij zolang ze in het contextvenster blijven en neemt ze op in de tool-output.

Parameters

Afbeeldingsgeneratie

• prompt: tekstbeschrijving (vereist)
• size: auto (standaard), 1024x1024 (vierkant), 1536x1024 (liggend), of 1024x1536 (staand)
• quality: auto (standaard), high, medium, of low
• background: auto (standaard), transparent, of opaque (transparent vereist PNG- of WebP-formaat)

Afbeeldingen bewerken

• image_ids: array van image IDs om te gebruiken als referentie voor het bewerken (vereist)
• prompt: tekstuele beschrijving van de wijzigingen (vereist)
• size: auto (standaard), 1024x1024, 1536x1024, 1024x1536, 256x256, of 512x512
• quality: auto (standaard), high, medium, of low

Setup

Maak een OpenAI-sleutel aan of hergebruik er een en voeg deze toe aan .env, voeg vervolgens "OpenAI Image Tools" toe aan de Tools-lijst van je agent:

IMAGE_GEN_OAI_API_KEY=sk-...
# optional extras
IMAGE_GEN_OAI_MODEL=gpt-image-1
IMAGE_GEN_OAI_BASEURL=https://...

Voor Azure OpenAI-implementaties, vraag eerst toegang aan op https://aka.ms/oai/gptimage1access en voeg daarna je inloggegevens toe aan .env:

IMAGE_GEN_OAI_API_KEY=your-api-key
# optional extras
IMAGE_GEN_OAI_MODEL=gpt-image-1
IMAGE_GEN_OAI_BASEURL=https://deploymentname.openai.azure.com/openai/deployments/gpt-image-1/
IMAGE_GEN_OAI_AZURE_API_VERSION=2025-04-01-preview

Geavanceerde configuratie

Pas de toolbeschrijvingen en promptbegeleiding aan met deze omgevingsvariabelen:

# Image Model
IMAGE_GEN_OAI_MODEL=gpt-image-1

# Image Generation Tool Descriptions
IMAGE_GEN_OAI_DESCRIPTION=...
IMAGE_GEN_OAI_PROMPT_DESCRIPTION=...

# Image Editing Tool Descriptions
IMAGE_EDIT_OAI_DESCRIPTION=...
IMAGE_EDIT_OAI_PROMPT_DESCRIPTION=...

Prijzen

Zie de GPT-Image-1 pricing page en de Image Generation documentation voor de kosten van het genereren van afbeeldingen.

Gemini Image Tools

Gemini Image Tools integreren de nieuwste afbeeldingsgeneratiemodellen van Google, met ondersteuning voor zowel tekst-naar-afbeelding generatie als beeldbewerking met contextbewustzijn.

• Text-to-image generation: creëer afbeeldingen van hoge kwaliteit op basis van gedetailleerde tekstbeschrijvingen.
• Ondersteuning voor afbeeldingscontext: gebruik bestaande afbeeldingen als context of inspiratie voor nieuwe generaties.
• Afbeeldingsbewerking: genereer nieuwe afbeeldingen op basis van wijzigingen aan bestaande afbeeldingen (inclusief het originele afbeeldings-ID).
• Meerdere modellen: kies gemini-2.5-flash-image (standaard) of gemini-3-pro-image-preview.
• Dual API support: werkt met zowel eenvoudige Gemini API-sleutels als Google Cloud Vertex AI.

Parameters

• prompt: gedetailleerde tekstbeschrijving van de gewenste afbeelding (vereist, tot 32.000 tekens)
• image_ids: optionele array van image IDs om te gebruiken als visuele context voor generatie

Setup

Voor de Gemini API, haal een sleutel op bij Google AI Studio:

GEMINI_API_KEY=your_api_key_here

Voor Vertex AI (Google Cloud-gebruikers met Vertex AI-toegang):

GOOGLE_SERVICE_KEY_FILE=/path/to/service-account.json
GOOGLE_CLOUD_LOCATION=us-central1  # optional, default: global

Modelselectie

# Default model (fast and efficient)
GEMINI_IMAGE_MODEL=gemini-2.5-flash-image

# Higher quality model
GEMINI_IMAGE_MODEL=gemini-3-pro-image-preview

Geavanceerde configuratie

Pas toolbeschrijvingen aan via omgevingsvariabelen:

GEMINI_IMAGE_GEN_DESCRIPTION=...
GEMINI_IMAGE_GEN_PROMPT_DESCRIPTION=...
GEMINI_IMAGE_IDS_DESCRIPTION=...

Meer details zijn te vinden in de speciale Gemini Image Gen guide.

DALL·E (verouderd)

DALL·E biedt verouderde (legacy) afbeeldingsgeneratie met behulp van OpenAI's dall-e-3 afbeeldingsmodel.

Parameters

• prompt: tekstbeschrijving van de gewenste afbeelding (vereist, maximaal 4000 tekens)
• style: vivid (hyper-realistisch, dramatisch, standaard) of natural (minder hyper-realistisch)
• quality: standard (standaard) of hd
• size: 1024x1024 (standaard, vierkant), 1792x1024 (breed), of 1024x1792 (hoog)

Setup

# Required
DALLE_API_KEY=sk-...  # or DALLE3_API_KEY=sk-...

# Optional
DALLE_REVERSE_PROXY=https://...  # Alternative endpoint
DALLE3_BASEURL=https://...  # For Azure or custom endpoints
DALLE3_AZURE_API_VERSION=2023-12-01-preview  # For Azure deployments
DALLE3_SYSTEM_PROMPT=...  # Custom system prompt for DALL·E

Schakel de DALL·E tool in voor de agent en begin met prompten.

Geavanceerde configuratie

Voor Azure OpenAI-implementaties configureert u de base URL en API-versie:

DALLE3_BASEURL=https://your-resource-name.openai.azure.com/openai/deployments/your-deployment-name
DALLE3_AZURE_API_VERSION=2023-12-01-preview
DALLE3_API_KEY=your-azure-api-key

Prijzen

Zie de DALL-E pricing page en de Image Generation documentation voor de kosten van het genereren van afbeeldingen.

Stable Diffusion (lokaal)

Draai afbeeldingen volledig op je eigen machine of server. Wijs LibreChat naar een willekeurig Automatic1111 (of compatibel) endpoint en je bent klaar.

Parameters

• prompt: gedetailleerde trefwoorden die de gewenste elementen in de afbeelding beschrijven (vereist)
• negative_prompt: trefwoorden die elementen beschrijven die moeten worden uitgesloten van de afbeelding (vereist)

De Stable Diffusion-implementatie gebruikt deze vaste standaardparameters, die voor de meeste use-cases goede resultaten opleveren:

• cfg_scale: 4.5
• stappen: 22
• width: 1024
• height: 1024

Setup

Er is geen API-sleutel vereist, enkel de bereikbare URL van je Automatic1111 WebUI:

SD_WEBUI_URL=http://127.0.0.1:7860  # URL to your Automatic1111 WebUI

Meer details over het instellen van Automatic1111 zijn te vinden in de speciale Stable Diffusion guide.

Flux

Cloud-generator met de nadruk op snelheid en optionele fine-tuned modellen.

• Snelle cloud-gebaseerde afbeeldingsgeneratie
• Ondersteuning voor fine-tuned modellen
• Meerdere kwaliteitsniveaus en beeldverhoudingen
• Raw-modus voor minder bewerkte, natuurlijker ogende afbeeldingen

Parameters

De Flux tool ondersteunt drie hoofdacties:

1. generate: maak een nieuwe afbeelding op basis van een tekstprompt
2. generate_finetuned: maak een afbeelding met behulp van een fine-tuned model
3. list_finetunes: lijst beschikbare aangepaste modellen voor de gebruiker

Meer details zijn te vinden in de speciale Flux guide.

Setup

Kies de Flux tool binnen de agent. Prompts zijn platte tekst en één aanroep produceert één afbeelding.

FLUX_API_KEY=flux_live_...
FLUX_API_BASE_URL=https://api.us1.bfl.ai   # default is fine for most users

Prijzen

Zie de Flux pricing page voor de kosten van het genereren van afbeeldingen.

Model Context Protocol (MCP)

Afbeeldingsoutputs worden ondersteund vanuit MCP servers. De Puppeteer MCP Server kan bijvoorbeeld screenshots van webpagina's genereren, die de afbeelding in het verwachte formaat uitvoeren en op dezelfde manier worden behandeld als de ingebouwde afbeeldingshulpmiddelen van LibreChat.

mcpServers:
  puppeteer:
    command: npx
    args:
      - -y
      - '@modelcontextprotocol/server-puppeteer'

Het volgende is een voorbeeld van een Image Generation server die afbeeldingen uitvoert met behulp van de Replicate API, maar URL's van de afbeeldingen retourneert, wat niet voldoet aan de standaard voor afbeeldingsreacties van MCP.

mcpServers:
  image-gen:
    command: 'node'
    # First, install the package globally using npm:
    # `npm install -g @gongrzhe/image-gen-server`
    # Then, point to the location of the installed package,
    # which you can find by running `npm root -g`
    args:
      - '{REPLACE_WITH_NODE_MODULES_LOCATION}/@gongrzhe/image-gen-server/build/index.js'
      # Example with output from `npm root -g`:
      # - "/home/danny/.nvm/versions/node/v24.16.0/lib/node_modules/@gongrzhe/image-gen-server/build/index.js"
    env:
      # Do not hardcode the API token here, use the environment variable instead
      # The following will pick up the token from your .env file or environment
      REPLICATE_API_TOKEN: '${REPLICATE_API_TOKEN}'
      MODEL: 'google/imagen-3'

Afbeeldingsopslag en -verwerking

Alle gegenereerde afbeeldingen zijn:

1. Opgeslagen volgens de geconfigureerde fileStrategy
2. Direct weergegeven in de chatinterface
3. Verzonden naar de LLM als onderdeel van de onmiddellijke chatcontext na generatie

Er gelden een paar kanttekeningen bij dat laatste punt:

• Dit kan problemen veroorzaken bij een LLM die geen ondersteuning biedt voor invoer van afbeeldingen. Een optie om dit gedrag per agent uit te schakelen is gepland.
• Outputs worden alleen naar de LLM verzonden tijdens het genereren, niet bij elk bericht.
• Om een afbeelding in latere beurten toe te voegen, bevestig je deze aan het bericht vanuit het zijpaneel.
• Kort gezegd krijgt de LLM alleen visuele context van afbeeldingen die aan gebruikersberichten zijn toegevoegd, en van generaties of bewerkingen direct nadat deze hebben plaatsgevonden.

Proxy-ondersteuning

Alle tools voor het genereren van afbeeldingen ondersteunen proxy-configuratie via de PROXY omgevingsvariabele:

PROXY=http://proxy-url:port

Wanneer PROXY niet is ingesteld, respecteren ondersteunde server-side clients HTTP_PROXY, HTTPS_PROXY en NO_PROXY/no_proxy.

Foutafhandeling

Als een tool een fout tegenkomt, wordt er een bericht geretourneerd waarin wordt uitgelegd wat er misging. Veelvoorkomende problemen zijn:

• Ongeldige API-sleutel
• API-onbeschikbaarheid
• Schendingen van het contentbeleid
• Proxy/netwerkproblemen
• Ongeldige parameters
• Niet-ondersteunde image payload (zie Image Storage and Handling hierboven)

Prompting

Je kunt de prompts voor OpenAI Image Tools en DALL·E aanpassen, maar de volgende tips vormen de basis voor de standaardprompts die de tools leveren, wat nuttig is om te weten voor je eigen schrijfwerk:

1. Begin met het onderwerp en de stijl (foto, olieverfschilderij, enz.).
2. Voeg compositie en camera/medium toe ("groothoekopname van…", "aquarel…").
3. Vermeld belichting en sfeer ("golden hour", "dramatische schaduwen").
4. Eindig met detail trefwoorden (texturen, kleuren, expressies).
5. Houd negatieven positief: beschrijf wat er moet worden opgenomen, niet wat moet worden vermeden.

Voorbeeld:

Een filmische foto van een antieke bibliotheek badend in warm middaglicht. Hoge houten planken puilen uit van de in leer gebonden boeken en stofdeeltjes glinsteren in het licht. Een enkele groene bankierslamp verlicht een open atlas op een gepolijst mahoniehouten bureau op de voorgrond. 85 mm lens, geringe scherptediepte, rijke amberkleurige tinten, ultra-hoog detail.

Gerelateerde pagina's