Mage API · Gemaakt voor je volgende idee
Eén API. Eindeloze mogelijkheden.
Haal het beste van Mage in je product en je AI-assistent. Genereer afbeeldingen, video en audio met één API-sleutel of één MCP-verbinding.
https://api.mage.space/v1In één oogopslag
Mage biedt ontwikkelaars een REST API op https://api.mage.space/v1 en een externe MCP-server op https://mcp.mage.space/mcp. Beide draaien dezelfde 37 modellen voor afbeeldingen, video en audio, waaronder de Mage-exclusieve Mango 4 en Cherry 2 Pro, met één account. Elke generatie betaal je in Gems, zonder abonnement.
- 37Modellen
- 3Mediatypes
- 16MCP-tools
- $0Maandelijkse kosten
Manieren om te starten
Gebruik het vanuit code, je assistent of ComfyUI
De Mage API
Dien generaties in vanuit je eigen code met een sleutel. Asynchrone verzoeken, idempotente nieuwe pogingen, uploads tot 100 MB en 20 generaties tegelijk.
TypeScript- en Python-SDK's
Officiële, getypeerde clients die in een paar regels indienen, op het resultaat wachten, veilig opnieuw proberen en bestanden uploaden.
De Mage MCP-server
Verbind Claude, ChatGPT, Claude Code, Grok of Cursor met een login en vraag in gewone taal om afbeeldingen, video en audio.
Mage voor ComfyUI
Mango, Cherry, Seed Audio en alle andere Mage-modellen als ComfyUI-nodes. Geen GPU, geen modellen downloaden.
Per mediatype
Generatie-API's
API voor AI-afbeeldingen genereren
Tekst naar afbeelding, bewerken en consistente personages tot 4K.
API voor AI-video genereren
Tekst naar video, afbeelding naar video, frames, referenties en geluid.
API voor AI-audio genereren
Stemmen, voice-overs, muziek en geluidseffecten vanuit een prompt.
Snel starten
Je eerste generatie
Maak een sleutel aan via API → API Keys, exporteer die als MAGE_API_KEY en voer een van deze voorbeelden uit.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/mango/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": "mango-v4"
}' | 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('mango', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'mango-v4',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("mango", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "mango-v4",
})
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.
MCP
Mage in je AI-assistent
Mage in Claude
Genereer afbeeldingen, video en audio in Claude op het web, in de desktopapp, in de mobiele apps en in Cowork.
Mage in ChatGPT
Genereer afbeeldingen, video en audio in ChatGPT als persoonlijke MCP-app.
Mage in Claude Code
Genereer afbeeldingen, video's en audio in Claude Code, in je terminal en editor.
Mage in Grok
Genereer afbeeldingen, video's en audio in Grok als aangepaste connector.
Mage in Cursor
Genereer afbeeldingen, video's en audio in de Agent-modus van Cursor.
Modellen
Uitgelichte modellen
Flux 2 API
Lange prompts en bewerkingen met meerdere referenties
GPT Image 2 API
Nauwkeurige prompts en leesbare tekst
Guava API
Fotorealisme dat voor een echte foto doorgaat
Mango API
Onze vlaggenschip-afbeeldingsfamilie
Nano Banana 2 API
Scherpe, leesbare tekst, tot 4K
Cherry API
Onze vlaggenschip-videofamilie
Lemon API
Alle videofuncties, tegen een vriendelijkere prijs
Plum API
Geluid bij elke clip, tot 2K
Seed Audio API
Stemmen, muziek en geluidseffecten vanuit één prompt
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.
FAQ
Veelgestelde vragen
Wat is de Mage API?
Wat is de Mage MCP-server?
Heb ik een API-sleutel nodig om de MCP-server te gebruiken?
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.