In één oogopslag
De GPT Image 2 API draait GPT Image 2 en 2 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 ondersteunt opgeslagen personages en referenties via @handle in de prompt.
Afbeelding
Uitvoer
3
Varianten
9
Gems per afbeelding, standaard
$0.009
Ongeveer, 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 vanaf veel referentiebeelden. Het veiligheidsfilter van OpenAI is van toepassing.
GPT Image 2, GPT Image 2.5 Flare en GPT Image 2.5 Sunburst van OpenAI, voor generatie en bewerkingen. 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_id | Naam | Standaard |
|---|---|---|
| gpt-image-2 | GPT Image 2 | Ja |
| gpt-image-2.5-flare | GPT Image 2.5 Flare | |
| gpt-image-2.5-sunburst | GPT Image 2.5 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.
| Veld | Waarden |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 1K, 2K |
Invoer
Media-invoer die GPT Image 2 accepteert
Stuur elk als https-URL, data-URL of upload tot 100 MB.
| Veld | Rol |
|---|---|
| image | De referentieafbeelding. |
| additional_images | Extra 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.
Meer beeldmodellen
Andere API's voor beeldgeneratie op Mage
Afbeelding · vanaf 75 Gems
Grok Image API
Grok Imagine, in drie kwaliteitsniveaus
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 135 Gems
Mango API
Onze vlaggenschip-afbeeldingsfamilie
Afbeelding · vanaf 68 Gems
Nano Banana 2 API
Scherpe, leesbare tekst, tot 4K
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). 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.