Afbeeldingen

Afbeeldingen bewerken en referentieafbeeldingen

Geef een afbeeldingsmodel beelden als uitgangspunt: bewerk een foto, plaats een product in een nieuwe scène, houd een personage consistent in verschillende beelden van voeg meerdere afbeeldingen samen tot één.

Twee manieren om afbeeldingen te versturen

EndpointAccepteertGeschikt voor
POST /v1/images/editsHet multipart-formulier van OpenAI (afbeeldingsbestanden), of JSONDe SDK's van OpenAI: client.images.edit(...)
POST /v1/images/generationsJSON met een images-lijstElke HTTP-client; afbeeldingen als links of data-URL's

Beide ondersteunen dezelfde modellen, formaten en prijzen als genereren. Een bewerking kost evenveel als een nieuwe afbeelding van dat formaat.

Hoeveel afbeeldingen elk model accepteert

ModelIDFormaten en prijzenReferentieafbeeldingen
Nano Banana 2.1nano-banana-2.11K $0.03 · 2K $0.04 · 4K $0.06maximaal 14
Nano Banana Pronano-banana-pro1K en 2K $0.035 · 4K $0.065maximaal 14
Nano Banana 2nano-banana-21K $0.025 · 2K $0.034 · 4K $0.058maximaal 14
Nano Banana 2 Litenano-banana-2-lite1K $0.016maximaal 14
GPT Image 2.5 Flaregpt-image-2.5-flare1K $0.028 · 2K $0.034 · 4K $0.045maximaal 16
GPT Image 2.5 Sunburstgpt-image-2.5-sunburst1K $0.026 · 2K $0.034 · 4K $0.045maximaal 16
GPT Image 2gpt-image-2$0.02 per afbeeldingmaximaal 16
Grok Imagine Image 2.0grok-imagine-image-2.01K $0.045 · 2K $0.06maximaal 3
FLUX 3 Imageflux-3-image1K $0.04 · 2K $0.05 · 4K $0.09maximaal 1

Met de SDK's van OpenAI

import os
from openai import OpenAI
client = OpenAI(base_url="https://api.zurelay.com/v1", api_key=os.environ["ZURELAY_API_KEY"])
result = client.images.edit(
model="gpt-image-2",
image=[open("product.png", "rb"), open("background.jpg", "rb")],
prompt="Put the bottle from the first image on the marble counter in the second. Keep its label exactly.",
)
print(result.data[0].url)

Als JSON

Geef bij beide endpoints de afbeeldingen in images op als links of data-URL’s (image met één afbeelding werkt ook):

import os
import requests
response = requests.post(
"https://api.zurelay.com/v1/images/generations",
headers={"Authorization": f"Bearer {os.environ['ZURELAY_API_KEY']}"},
json={
"model": "nano-banana-pro",
"prompt": "Make the jacket in the first image deep green, and give the model the pose from the second.",
"images": [
"https://example.com/model.jpg",
"data:image/png;base64,iVBORw0KGgo..."
],
"size": "2K",
"aspect_ratio": "4:5"
},
)
response.raise_for_status()
print(response.json())

Regels voor invoerafbeeldingen

  • PNG, JPEG of WebP, maximaal 20 MB per afbeelding.
  • Links moeten openbare https-URL’s zijn; we downloaden ze zelf. Als een afbeelding niet kan worden gedownload, wordt de aanvraag met invalid_image geweigerd voordat er iets wordt gemaakt.
  • Verwijs naar afbeeldingen op volgorde in de prompt: “de eerste afbeelding”, “de tweede afbeelding”.
  • Maskers worden niet ondersteund. Beschrijf de wijziging in plaats daarvan (“vervang alleen de lucht”); deze modellen bewerken alleen wat je noemt.
  • Als je de limiet van een model overschrijdt, wordt de aanvraag geweigerd met een duidelijke foutmelding die de limiet vermeldt.

Wat je kunt proberen

DoelPromptpatroon
Eén ding wijzigen“Maak de auto matzwart. Laat al het andere hetzelfde.”
Nieuwe achtergrond“Plaats de persoon uit de afbeelding op een strand bij zonsondergang en pas de belichting daarop aan.”
Product in een scène“Zet het product uit de eerste afbeelding op de plank in de tweede.”
Hetzelfde personage, nieuwe opname“Dezelfde vrouw als in de referentieafbeeldingen, nu fietsend in Parijs.”
Stijloverdracht“Teken de eerste afbeelding opnieuw in de stijl van de tweede.”
Meerdere combineren“Een groepsfoto van de zes mensen uit de afbeeldingen, staand op een trap.”

Vragen, of ontbreekt er iets? Vraag het ons supportteam en je krijgt antwoord per e-mail, meestal binnen een minuut.