Een eenvoudige afbeeldingsaanroep van GPT Image 2.5 naar 2.6 overzetten, komt neer op een wijziging van de model-ID. De eindpunten zijn hetzelfde, de tokentarieven zijn hetzelfde en de drie aanbevolen formaten zijn hetzelfde. De aandachtspunten zijn Batch, dat 2.5 wel heeft en 2.6 niet; de afbeeldingsfunctie van Responses, die OpenAI in de documentatie voor 2.5 en 2.6 verschillend beschrijft; en de instellingen — complexiteit, SVG, GIF en markup — die wel in de documentatie voor OpenAI's Image API staan, maar nog niet in het gepubliceerde parameterschema van AIHubMix.
In deze handleiding voeren we via AIHubMix één representatieve taak uit: een poster van 1536x1024 met een kop en een productafbeelding. We beginnen met drie goedkope Flare-concepten, kiezen er één, maken de eindversie met Sunburst en vermelden bij elke stap de kosten. Onderweg bespreken we de migratieproblemen die ongemerkt misgaan in plaats van duidelijk te falen.
Wat hetzelfde blijft
De twee 2.6-modellen zijn gpt-image-2.6-sunburst en gpt-image-2.6-flare. Beide worden aangeroepen via v1/images/generations en v1/images/edits; geen van beide heeft een gewone alias gpt-image-2.6. Tekstinvoer kost $5 per miljoen tokens, afbeeldingsinvoer $8 en afbeeldingsuitvoer $30, precies hetzelfde als bij 2.5 en GPT Image 2.
Dat betekent dat een pipeline die is gebouwd rond de Image API dezelfde aanvraagstructuur behoudt. Alleen de modelstring verandert, en alleen als je het nieuwe model wilt gebruiken. De snelheidsclaim — volgens de modelpagina van AIHubMix is de hele modelfamilie 50% sneller — is de belangrijkste reden om vanaf dag één over te stappen.
Migratievalkuilen
Batch is verdwenen
Dit is de enige functie waarbij 2.5 onmiskenbaar een voordeel heeft. De modelpagina van GPT Image 2.5 vermeldt dat v1/batch wordt ondersteund, en voor Batch kost afbeeldingsuitvoer $15 per miljoen tokens in plaats van $30. Op de modelpagina van GPT Image 2.6 staat dat Batch niet wordt ondersteund, en in de prijstabel voor Batch ontbreken beide 2.6-modellen.
Als je 's nachts afbeeldingsopdrachten uitvoert, stap dan niet over op 2.6. Blijf bij 2.5 of splits de werklast op: interactieve concepten op 2.6, batchrenders op 2.5. In de afbeeldingsdocumentatie van AIHubMix staat geen Batch-eindpunt, dus deze keuze geldt alleen voor rechtstreekse aanroepen bij OpenAI.
Controleer pipelines die Responses gebruiken
De eigen documentatie van OpenAI spreekt elkaar op dit punt tegen voor 2.5. In de changelog van september staat de afbeeldingsgeneratiefunctie van de Responses API naast de Image API, maar op de modelpagina van 2.5 staat dat Responses niet wordt ondersteund. Voor 2.6 is het beeld duidelijker: op de modelpagina staat dat Responses niet wordt ondersteund, en in de changelog van november worden alleen v1/images/generations en v1/images/edits vermeld.
Als je code 2.5 via Responses aanroept, voeg dan een rooktest toe voordat je de model-ID wijzigt. Een fout hierbij is duidelijk, maar alleen als je test; een pipeline die ongemerkt terugvalt op een ander model is erger dan een 400.
De nieuwe instellingen zijn alleen beschikbaar via de Image API
In de handleiding voor afbeeldingsgeneratie staan complexity, bewerkingen op basis van markup, SVG-uitvoer en geanimeerde GIF-uitvoer bij de Image API. Geen daarvan is beschikbaar via de afbeeldingsfunctie van Responses, en SVG en GIF zijn alleen voor generatie: ze werken niet met /v1/images/edits.
Elk heeft eigen beperkingen. Voor SVG is n=1 vereist en worden streaming, gedeeltelijke afbeeldingen, output_compression en prompt_rewriter niet ondersteund. GIF gebruikt frame_count (standaard 9) en frame_duration_ms (standaard 200), is alleen beschikbaar voor generatie en ondersteunt evenmin streaming, gedeeltelijke afbeeldingen, aangepaste output_compression of prompt_rewriter. Voor bewerkingen met markup moet de oorspronkelijke afbeelding als eerste invoerafbeelding worden meegegeven, samen met een afzonderlijke transparante PNG met dezelfde afmetingen; beide mogen niet groter zijn dan 16,777,216 pixels en het markupbestand mag maximaal 50 MB zijn. Combineer markup niet met mask of prompt_rewriter.
Voor SVG geldt ook een aparte factureringsregel: je betaalt het tarief van het afbeeldingsmodel voor de referentieafbeelding en het tarief van het model dat de SVG maakt voor de tokens die daarvoor worden gebruikt. De totale kosten hangen van beide af, dus de gebruikelijke schatting per afbeelding is hiervoor niet toereikend.
De documentatie over kwaliteit en formaat spreekt elkaar tegen
Voor 2.5 documenteert OpenAI vijf expliciete kwaliteitsniveaus naast auto: low, medium, high, xhigh en max. Voor 2.6 vermeldt de kostencalculator in de handleiding dezelfde vijf voor beide modellen, koppelt de API-referentie xhigh en max alleen aan momentopnamen van 2.5, en berekent de tabel per afbeelding van AIHubMix — de bron voor de kosten hieronder — alleen de prijzen voor low, medium, high en auto.
De veilige opties voor 2.6 zijn op dit moment low, medium, high en auto. Dezelfde voorzichtigheid geldt voor formaten: aangepaste waarden voor WIDTHxHEIGHT worden gedocumenteerd voor GPT Image 2 en 2.5, terwijl de handleiding voor 2.6 de formaten 1024x1024, 1536x1024 en 1024x1536 aanbeveelt. Gebruik de drie aanbevolen formaten totdat de documentatie voor 2.6 op één lijn zit.
Bij de overstap vanaf 1.5 kost 1024x1024 met hoge kwaliteit meer
GPT Image 1.5 en 1-mini worden op 1 december 2026 uitgefaseerd, waarbij 2.5 als vervanger wordt genoemd. Als je meestal rendert op 1024x1024 met hoge kwaliteit, is de overstap niet goedkoop: in de prijstabel van OpenAI kost hoge kwaliteit voor 1.5 $0.133, terwijl de schatting van AIHubMix voor 2.6 $0.211 is, ongeveer 59% meer. Medium stijgt van $0.034 naar $0.053, terwijl low juist daalt van $0.009 naar $0.006. Op 1536x1024 kost high voor 1.5 $0.200; op dat formaat is 2.6 met $0.165 dus goedkoper.
Voer dezelfde mix eerst uit op 2.5 voordat je ervan uitgaat dat 2.6 voordeliger is: de tokentarieven zijn identiek, dus het verschil tussen de twee 2.x-modellen zit in het tokenverbruik, niet in de catalogusprijs.
2.6 aanroepen via AIHubMix
AIHubMix biedt beide 2.6-modellen aan tegen de officiële tarieven. In de documentatie voor afbeeldingsgeneratie van AIHubMix staat het nieuwere eindpunt: POST https://aihubmix.com/ai/v1/images/generations. Dit accepteert model, prompt, n, size, output_format, image, images, mask, async, extra en de twee webhookvelden.
Belangrijk is waar de kwaliteit wordt ingesteld. Het eindpunt /ai/v1/images/generations heeft geen veld quality op het hoogste niveau; het hoort binnen extra:
curl -s https://aihubmix.com/ai/v1/images/generations \
-H "Authorization: Bearer $AIHUBMIX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.6-flare",
"prompt": "A minimal poster: a single ceramic coffee mug on a pale sand background, soft morning light, large empty space at the top for a headline",
"size": "1024x1024",
"n": 3,
"extra": { "quality": "low" }
}'
De respons bevat een of meer uitvoer-URL's. Deze zijn slechts kort geldig — ongeveer 30 minuten — en moeten worden gedownload met dezelfde header Authorization: Bearer $AIHUBMIX_API_KEY:
curl -s -H "Authorization: Bearer $AIHUBMIX_API_KEY" "<output-url>" -o draft-1.png
In de documentatie raadt AIHubMix /ai/v1 aan voor nieuwe integraties: de OpenAI-compatibele eindpunten op /v1 ondersteunen mogelijk nog niet de nieuwste modellen, en in de modellijst van de verouderde afbeeldingsreferentie staan gpt-image-2, gpt-image-1.5, gpt-image-1-mini en de DALL·E-modellen, maar geen 2.6. Het schema per model vermeldt wel een item /v1/images/generations voor 2.6, maar /ai/v1 is het pad dat AIHubMix documenteert voor 2.6 en dat asynchrone taken en webhooks toevoegt.
Wat het schema niet beschikbaar stelt
In het gepubliceerde schema van AIHubMix voor 2.6 accepteert output_format alleen de waarden png, jpeg en webp. Het bevat geen complexity, markup, frame_count of frame_duration_ms, en biedt geen uitvoer in svg of gif. Het schema is zonder authenticatie beschikbaar op https://aihubmix.com/call/schema/models/gpt-image-2.6-flare/endpoints en is de eerste plek om te controleren voordat je op een van die functies via de gateway vertrouwt.
Dit is een hiaat in het schema, geen vastgestelde fout: de functies staan in de documentatie van OpenAI en de gateway kan ze later toevoegen. Plan SVG-, GIF- en markupwerk zolang ze niet in het schema staan als rechtstreekse aanroepen naar OpenAI.
Fouten die je kunt verwachten
| Status | Betekenis | Wat je moet doen |
|---|---|---|
| 400 | Parameterfout, vaak doorgegeven door de aanbieder | Controleer prompt, formaat en n |
| 401 | Ontbrekende of ongeldige sleutel | Controleer de Authorization-header |
| 402 | Onvoldoende quota | Voeg tegoed toe |
| 403 | Toegang geweigerd | Controleer het account, de rechten van de sleutel en de IP-beperkingen |
| 429 | Snelheidslimiet bereikt | Wacht even en probeer opnieuw |
| 503 | Geen kanaal kan de aanvraag verwerken | Controleer de model-ID en probeer het later opnieuw |
In de foutmeldingen van AIHubMix staat een trace-ID tid. Bewaar deze voor ondersteuning en probeer een 400 niet ongewijzigd opnieuw. Dit is het contract van /ai/v1; de verouderde eindpunten /v1 melden onvoldoende quota in plaats daarvan als 403 insufficient_user_quota.
De workflow: drie concepten, één eindversie
De opdracht is een poster met een productafbeelding en een kop. De prompt blijft hetzelfde; alleen het model, formaat en de kwaliteit veranderen.
Stap 1 — maak een concept met Flare. Eén aanvraag met n=3 op 1024x1024 en lage kwaliteit levert drie richtingen op. Bij een geschatte prijs van $0.006 per afbeelding kost deze stap $0.018.
Stap 2 — kies er één. Dit is het goedkope deel van de workflow en het deel dat het meest profiteert van de snelheid van het model. Drie concepten in één aanroep is een normaal budget, geen luxe.
Stap 3 — maak de eindversie met Sunburst. Geef de gekozen compositie opnieuw op als prompt, op 1536x1024 en met hoge kwaliteit. Bij een geschatte prijs van $0.165 per afbeelding is dit de dure stap; één eindversie kost ongeveer 28 keer zoveel als één conceptafbeelding, of ongeveer negen keer zoveel als de stap met drie concepten.
curl -s https://aihubmix.com/ai/v1/images/generations \
-H "Authorization: Bearer $AIHUBMIX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.6-sunburst",
"prompt": "A minimal poster: a single ceramic coffee mug on a pale sand background, soft morning light, large empty space at the top for a headline. Refined studio product photography, subtle shadow, no text",
"size": "1536x1024",
"n": 1,
"extra": { "quality": "high" }
}'
Stap 4 — bereken het totaal. De geschatte $0.018 voor de concepten plus $0.165 voor de eindversie komt neer op $0.183 voor vier uitvoerafbeeldingen. Als de eindversie in plaats daarvan met gemiddelde kwaliteit wordt gemaakt, kost die $0.041 en komt de hele run uit op $0.059. Tekstinvoertokens voegen bij prompts van deze lengte een fractie van een cent toe; bij een bewerking komen daar afbeeldingsinvoertokens bij tegen $8 per miljoen.
Dit bedrag laat zien dat er geen kostenverschil is tussen de twee modellen: dezelfde vier afbeeldingen kosten op 2.5 evenveel, omdat de schattingen per afbeelding van AIHubMix overeenkomen. De reden om 2.6 te gebruiken is de snellere conceptcyclus en de mogelijkheid om SVG- of GIF-werk later naar OpenAI over te zetten, niet een lagere rekening.
Migratiechecklist
- Vervang
gpt-image-2.5-sunburstengpt-image-2.5-flaredoor de 2.6-ID's waar je het nieuwe model wilt gebruiken; laat Batch-opdrachten op 2.5 staan. - Controleer of een pipeline de afbeeldingsfunctie van Responses gebruikt; voor 2.6 wordt alleen de Image API gedocumenteerd.
- Beperk de kwaliteit tot
low,medium,highofautoen de formaten tot de drie aanbevolen waarden totdat de documentatie voor 2.6 is bijgewerkt. - Gebruik op AIHubMix's
/ai/v1extravoor quality; gebruik voor 2.6/ai/v1, het pad dat AIHubMix aanbeveelt voor nieuwe integraties. - Download de uitvoer-URL's binnen 30 minuten met de Bearer-header.
- Ga er niet van uit dat
complexity, markup, SVG of GIF via AIHubMix werkt zolang het schema dit niet vermeldt. - Gebruik je 1.5, houd dan rekening met de uitfasering op 1 december en controleer de kosten voor hoge kwaliteit opnieuw.
Veelgestelde vragen
Moet ik mijn eindpunt wijzigen voor GPT Image 2.6?
Op de API van OpenAI niet. Deze gebruikt v1/images/generations en v1/images/edits, net als 2.5; alleen de model-ID verandert. Gebruik op AIHubMix /ai/v1/images/generations, zoals hierboven beschreven.
Is GPT Image 2.6 goedkoper dan 2.5?
Nee. De tokenprijzen zijn identiek: $5 per miljoen tekstinvoertokens, $8 per miljoen afbeeldinginvoertokens en $30 per miljoen afbeeldingsuitvoertokens.
Waarom kan ik Batch niet gebruiken met GPT Image 2.6?
Op de modelpagina's van OpenAI staat dat Batch niet wordt ondersteund voor 2.6, en in de prijstabel voor Batch staat 2.5 maar niet 2.6. Batch is de duidelijkste toepassing waarvoor 2.5 de betere keuze blijft.
Hoe stel ik de kwaliteit in op AIHubMix?
Gebruik voor 2.6 op /ai/v1/images/generations de parameter extra.quality. Het OpenAI-compatibele /v1/images/generations heeft een veld quality op het hoogste niveau, maar AIHubMix raadt /ai/v1 aan voor nieuwe integraties; gebruik voor 2.6 /ai/v1.
Kan ik via AIHubMix SVG of GIF genereren?
Niet volgens het huidige schema. Daarin staan png, jpeg en webp, maar niet complexity, markup, het aantal frames of SVG/GIF-uitvoer. Die mogelijkheden zijn gedocumenteerd voor de Image API van OpenAI; controleer het schema voordat je erop vertrouwt dat ze via de gateway werken.
Hoe lang blijven uitvoer-URL's van AIHubMix geldig?
Ongeveer 30 minuten. Download ze met hetzelfde Bearer-token en sla het bestand zelf op.
Wat gebeurt er met GPT Image 1.5?
Deze wordt op 1 december 2026 uitgefaseerd. OpenAI noemt 2.5 als vervanger, maar bij 1024x1024 in hoge kwaliteit kost 2.6 per afbeelding meer dan 1.5; bij 1536x1024 kost het minder.
Lees verder: de GPT Image 2.6-serie
Het vergelijkingsartikel behandelt de prijstabellen, de snelheidsclaim en de toepassingen waarin 2.5 nog steeds wint. Het is een goed startpunt als je nog niet hebt besloten of je wilt overstappen.
GPT Image 2.6 vs 2.5: is de upgrade het waard?
