Mage API · Afbeeldingen genereren
De API voor AI-afbeeldingen genereren, met elk model
Tekst-naar-afbeelding, afbeeldingen bewerken en consistente personages met 18 modellen, waaronder het vlaggenschip Mango 4 van Mage, via één sleutel en één saldo.
POST https://api.mage.space/v1/{model}/generateIn één oogopslag
De Mage API voor het genereren van afbeeldingen is een REST API op https://api.mage.space/v1 waarmee je 18 modellen voor tekst-naar-afbeelding en afbeeldingen bewerken draait, waaronder Mango 4, Guava 2 Pro, GPT Image 2.6, Nano Banana 2, Flux 2 en Krea 2. Je stuurt een prompt met POST naar /{model}/generate, vraagt het verzoek op en downloadt de afbeelding. Elke afbeelding betaal je in Gems, zonder abonnement.
- 18afbeeldingsmodellen
- $0.009Goedkoopste standaardprijs per afbeelding
- 20Gelijktijdige generaties
- $0Maandelijkse kosten
Modellen
Alle afbeeldingsmodellen in de Mage API
Prijzen gelden per generatie, in Gems. 1.000 Gems kosten $1 in het standaardpakket, en grotere pakketten bevatten extra Gems. De prijs hangt af van model, resolutie en duur; getoond wordt de prijs bij standaardinstellingen, en elke respons geeft de exacte kosten weer in billing.gems_charged. Een mislukte generatie wordt terugbetaald; een generatie die door het contentbeleid van Mage wordt geblokkeerd niet.
| Model | Het meest geschikt voor | model_id-waarden | Standaardprijs |
|---|---|---|---|
| Anima | Speciaal gebouwd voor anime | anima-v1 | 20 Gems ($0.02) |
| Chroma | Open weights, gebouwd op Flux | chroma-v1-hd | 35 Gems ($0.035) |
| Flux 2 | Lange prompts en bewerkingen met meerdere referenties | flux2-dev | 40 Gems ($0.04) |
| GPT Image 2 | Precieze prompts en leesbare tekst | gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst, gpt-image-2.6-flare, gpt-image-2.6-sunburst | 9 Gems ($0.009) |
| Grok Image | Grok Imagine, in twee varianten | grok-imagine-image, grok-imagine-image-2.0 | 90 Gems ($0.09) |
| Guava | Fotorealisme dat voor een echte foto kan doorgaan | guava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro | 37 Gems ($0.037) |
| HiDream | Snel en veelzijdig, met negatieve prompts | hidream-fast | 20 Gems ($0.02) |
| Krea 2 | Prachtige esthetiek in seconden | krea-2-turbo | 20 Gems ($0.02) |
| Mango | Onze vlaggenschipfamilie voor afbeeldingen | mango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo, mango-v4 | 42 Gems ($0.042) |
| MiniMax H3 Image | Native afbeeldingen van 16 megapixel, open weights | minimax-h3-image | 15 Gems ($0.015) |
| MOSS-Image | Lange prompts en tweetalige tekst, open weights | moss-image | 25 Gems ($0.025) |
| Nano Banana 2 | Scherpe, leesbare tekst, tot 4K | nano-banana-v2, nano-banana-v2.1 | 51 Gems ($0.051) |
| SDXL Plus | SDXL met verbeterde gezichten en handen | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| Seedream | Seedream, met een strikt filter | seedream-4.0, seedream-4.5, seedream-5.0-lite, seedream-5.0-pro, seedream-5.0-flash, seedream-5.5 | 42 Gems ($0.042) |
| Stable Diffusion v1.5 | De klassieker, voor een klein budget | 15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D | 10 Gems ($0.01) |
| Stable Diffusion v3.5 Large | De Stable Diffusion die het best luistert | sd-3-5-large | 10 Gems ($0.01) |
| Stable Diffusion XL | SDXL afgestemd op fotorealisme | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 10 Gems ($0.01) |
| Z-Image | Het snelste afbeeldingsmodel van Mage | z-image-turbo | 10 Gems ($0.01) |
Snel starten
Genereer een afbeelding met Anima v1
Stel MAGE_API_KEY in, verstuur de aanvraag en poll tot die klaar is. Vervang anima in de URL door een van de modellen hierboven.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/anima/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": "anima-v1"
}' | 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('anima', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'anima-v1',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("anima", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "anima-v1",
})
print(request["result"]["url"])Zo werkt het
Van API-sleutel tot kant-en-klare media in drie aanroepen
Elk model gebruikt hetzelfde authenticatieschema, dezelfde asynchrone aanvraagcyclus en dezelfde veldnamen.
Maak een API-sleutel aan
Log in bij Mage, open API → API Keys en maak een sleutel aan. Die begint met mage_sk_ en wordt maar één keer getoond. Een account kan 10 actieve sleutels hebben.
Dien een generatie in
Stuur een POST met een JSON-body naar https://api.mage.space/v1/{model}/generate met een Authorization: Bearer-header. Het antwoord komt direct terug met een request_id, een status en een status_url. Stuur een Idempotency-Key-header mee, zodat een nieuwe poging nooit dubbel kost.
Poll en download
Poll status_url tot de status completed, failed of cancelled is. Een voltooid verzoek bevat result.url met het afbeeldings-, video- of audiobestand, dat 30 dagen bewaard blijft.
Gebouwd voor productie
Dit krijgt elke Mage API-aanvraag
Eén sleutel, elk model
37 modellen voor afbeeldingen, video en audio achter één REST API en één Gems-saldo. Wissel van model door het URL-pad aan te passen.
Betaal per generatie
Geen abonnement en geen minimumbesteding. Je koopt Gems en elke aanvraag kost de vermelde prijs. Een mislukte generatie wordt terugbetaald, tenzij het contentbeleid van Mage deze heeft geblokkeerd.
Veilig opnieuw proberen
Met idempotentiesleutels geeft een opnieuw verzonden aanvraag de oorspronkelijke aanvraag terug, zonder nogmaals kosten te rekenen.
Consistente personages
Sla een personage of referentie één keer op en schrijf daarna @handle in een prompt om het te gebruiken met elk model dat dit ondersteunt.
Grote invoer
Stuur afbeeldings-, video- en audio-invoer als URL's of data-URL's, of upload bestanden tot 100 MB via een ondertekende upload.
20 generaties tegelijk
Elk account kan 20 generaties tegelijk uitvoeren en de limiet kan voor jouw toepassing worden verhoogd. Geweigerde aanvragen worden nooit in rekening gebracht.
Toepassingen
Wat ontwikkelaars bouwen met de afbeeldings-API
Product- en marketingafbeeldingen
Maak productfoto's, advertentievarianten en socialmediaposts op aanvraag, met leesbare tekst dankzij GPT Image 2.6 of Nano Banana 2.
Consistente personages
Sla een personage één keer op en houd hetzelfde gezicht in een hele reeks met Mango 4, Guava 2 Pro en andere modellen die @handle-vermeldingen ondersteunen.
Pipelines voor beeldbewerking
Stuur een bronafbeelding met een instructie om precies te veranderen wat jij vraagt en de rest op zijn plek te laten.
Apps en games
Genereer avatars, stickers, kaarten en scènes in je product, zonder zelf één GPU te hosten.
Fotorealistische portretten
Guava 2 Pro rendert portretten, mode- en lifestylefoto's met levensechte huid, stof en licht.
Snelle concepten op schaal
Z-Image Turbo en Krea 2 houden de prijzen laag voor thumbnails in grote aantallen en eerste versies.
FAQ
Veelgestelde vragen
Wat is de beste API voor het genereren van afbeeldingen met AI?
Ondersteunt de afbeeldings-API beeldbewerking en referentieafbeeldingen?
Welke resoluties ondersteunt de afbeeldings-API?
Hoeveel kost de Mage API?
Heb ik een Mage-lidmaatschap nodig om de API te gebruiken?
Mag ik API-uitvoer commercieel gebruiken?
Wat zijn de rate limits?
Kan mijn AI-agent de Mage API gebruiken?
Is er een SDK voor de Mage API?
Ik gebruik al een andere generatie-API. Wat moet ik wijzigen?
Begin met bouwen met Mage
Eén account, één Gems-saldo, alle modellen. Je betaalt alleen voor wat je genereert.