Ga naar de inhoud

Mage API · Beeldmodel

GPT Image 2 API

Nauwkeurige prompts en leesbare tekst

POST https://api.mage.space/v1/gpt_image_2/generate

In één oogopslag

De GPT Image 2 API draait GPT Image 2 en 4 andere varianten via Mage op POST https://api.mage.space/v1/gpt_image_2/generate. Een verzoek met de standaardinstellingen kost 9 Gems (ongeveer $0,009), zonder abonnement. GPT Image 2 werkt met opgeslagen personages en referenties via @handle in de prompt.

  • AfbeeldingUitvoer
  • 5Varianten
  • 9Gems per afbeelding, standaard
  • $0.009Ongeveer, in USD

Overzicht

Wat de GPT Image 2 API doet

De GPT Image-modellen van OpenAI, die de prompt letterlijk volgen en leesbare tekst weergeven. Genereer of bewerk met veel referentie-afbeeldingen, of maak geanimeerde GIF's met GPT Image 2.6. Het veiligheidsfilter van OpenAI is van toepassing.

De GPT Image-modellen van OpenAI voor genereren en bewerken: GPT Image 2, GPT Image 2.5 Flare en Sunburst, en GPT Image 2.6 Flare en Sunburst, waarmee je ook geanimeerde GIF's maakt. Het veiligheidsfilter van OpenAI is van toepassing.

Accepteert image, additional_images als invoer.

Snel starten

De GPT Image 2 API aanroepen

Stel MAGE_API_KEY in, verstuur je verzoek naar /gpt_image_2/generate en poll status_url tot het verzoek is voltooid.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/gpt_image_2/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "4:5",
  "model_id": "gpt-image-2"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('gpt_image_2', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'gpt-image-2',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("gpt_image_2", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "gpt-image-2",
})

print(request["result"]["url"])

Modellen

model_id-waarden voor GPT Image 2

Stuur model_id mee om een variant te kiezen. Zonder model_id wordt de standaardvariant gebruikt.

model_idNaamStandaard
gpt-image-2GPT Image 2Ja
gpt-image-2.5-flareGPT Image 2.5 Flare
gpt-image-2.5-sunburstGPT Image 2.5 Sunburst
gpt-image-2.6-flareGPT Image 2.6 Flare
gpt-image-2.6-sunburstGPT Image 2.6 Sunburst

Opties

Parameters van GPT Image 2

Toegestane waarden voor alle varianten; een variant kan minder opties bieden. In de documentatie staan de opties per variant.

VeldWaarden
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K
output_formatjpeg, gif

Invoer

Media-invoer die GPT Image 2 accepteert

Stuur elk als https-URL, data-URL of upload tot 100 MB.

VeldRol
imageDe referentieafbeelding.
additional_imagesExtra referentieafbeeldingen.

Regels

Wat de GPT Image 2 API afdwingt

  • Elk model biedt alleen bepaalde `quality`-niveaus aan; een niveau dat het gekozen model niet aanbiedt, wordt geweigerd.
  • Zet `output_format` op `gif` bij een GPT Image 2.6-model voor een geanimeerde GIF, met `frame_count` van 2 tot 16 (standaard 9) en `frame_duration_ms` van 20 tot 2000 (standaard 200). Andere modellen weigeren dit. `resolution` is niet van toepassing: elke `aspect_ratio` heeft één framegrootte, rond de 640 pixels. Het resultaat is een `.gif`-bestand en het `type` blijft `image`.
  • De prijs van een GIF hangt af van `quality` en van het bereik waarin het aantal frames valt (2 tot 8, 9, 10 tot 12 of 13 tot 16), niet van elk frame apart. De prijstabel hieronder toont stilstaande afbeeldingen: de prijs van een GIF vind je in de kostenraming.
  • Een GIF op Mage, zoals een eerder resultaat, die je als afbeeldingsinvoer gebruikt, wordt uitgevoerd op het eerste frame. Een GIF van elders wordt geweigerd: afbeeldingsinvoer moet JPEG of PNG zijn.

Meer beeldmodellen

Andere API's voor beeldgeneratie op Mage

  • Afbeelding · vanaf 90 Gems

    Grok Image API

    Grok Imagine, in twee varianten

  • Afbeelding · vanaf 37 Gems

    Guava API

    Fotorealisme dat voor een echte foto doorgaat

  • Afbeelding · vanaf 20 Gems

    HiDream API

    Snel en veelzijdig, met negatieve prompts

  • Afbeelding · vanaf 20 Gems

    Krea 2 API

    Prachtige esthetiek in enkele seconden

  • Afbeelding · vanaf 42 Gems

    Mango API

    Onze vlaggenschip-afbeeldingsfamilie

  • Afbeelding · vanaf 15 Gems

    MiniMax H3 Image API

    Native afbeeldingen van 16 megapixel, open weights

FAQ

Veelgestelde vragen

Wat kost de GPT Image 2 API?
Een GPT Image 2-verzoek met de standaardinstellingen (GPT Image 2) kost 9 Gems, ongeveer $0,009. Andere resoluties, duur en varianten veranderen de prijs; in de respons staat het exacte bedrag. Een mislukte generatie wordt terugbetaald; een generatie die door het contentbeleid van Mage wordt geblokkeerd niet.
Wat is het endpoint van de GPT Image 2 API?
POST https://api.mage.space/v1/gpt_image_2/generate met een Authorization: Bearer-header met je Mage API-sleutel. De respons bevat een status_url die je kunt pollen voor het resultaat.
Welke GPT Image 2-modellen kan ik aanroepen?
gpt-image-2 (GPT Image 2), gpt-image-2.5-flare (GPT Image 2.5 Flare), gpt-image-2.5-sunburst (GPT Image 2.5 Sunburst), gpt-image-2.6-flare (GPT Image 2.6 Flare), gpt-image-2.6-sunburst (GPT Image 2.6 Sunburst). De standaard is GPT Image 2.
Ondersteunt GPT Image 2 referentieafbeeldingen of personages?
GPT Image 2 accepteert image, additional_images. GPT Image 2 gebruikt opgeslagen personages en referenties via @handle in de prompt.
Kan ik GPT Image 2 gebruiken via Claude of ChatGPT?
Ja. Koppel de Mage MCP-server aan Claude, ChatGPT, Claude Code, Grok of Cursor en vraag op naam om GPT Image 2. Je assistent leest de opties uit met get_model en noemt de prijs voordat er iets wordt gegenereerd.
Hoe lang worden GPT Image 2-resultaten bewaard?
Resultaten en invoer worden 30 dagen bewaard. Download alles wat je wilt houden naar je eigen opslag.

Begin met bouwen met Mage

Eén account, één Gems-saldo, alle modellen. Je betaalt alleen voor wat je genereert.

CharactersCommunity