Ga naar de inhoud

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/v1

In éé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

  • REST API

    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.

  • SDK's

    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.

  • MCP-server

    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.

  • ComfyUI

    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

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.

  1. 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.

  2. 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.

  3. 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

  • Afbeelding · vanaf 40 Gems

    Flux 2 API

    Lange prompts en bewerkingen met meerdere referenties

  • Afbeelding · vanaf 9 Gems

    GPT Image 2 API

    Nauwkeurige prompts en leesbare tekst

  • Afbeelding · vanaf 37 Gems

    Guava API

    Fotorealisme dat voor een echte foto doorgaat

  • Afbeelding · vanaf 42 Gems

    Mango API

    Onze vlaggenschip-afbeeldingsfamilie

  • Afbeelding · vanaf 51 Gems

    Nano Banana 2 API

    Scherpe, leesbare tekst, tot 4K

  • Video · vanaf 618 Gems

    Cherry API

    Onze vlaggenschip-videofamilie

  • Video · vanaf 245 Gems

    Lemon API

    Alle videofuncties, tegen een vriendelijkere prijs

  • Video · vanaf 173 Gems

    Plum API

    Geluid bij elke clip, tot 2K

  • Audio · vanaf 19 Gems

    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?
De Mage API is een REST API op https://api.mage.space/v1 waarmee je vanuit je eigen code afbeeldingen, video en audio genereert met 37 modellen. Verzoeken zijn asynchroon en je betaalt per generatie in Gems.
Wat is de Mage MCP-server?
Een externe Model Context Protocol-server op https://mcp.mage.space/mcp waarmee AI-assistenten afbeeldingen, video's en audio kunnen genereren op je Mage-account. De assistent krijgt 16 tools om een model te kiezen, de prijs op te vragen, te genereren, op het resultaat te wachten en je opgeslagen personages, referenties en geschiedenis te gebruiken.
Heb ik een API-sleutel nodig om de MCP-server te gebruiken?
Nee. Claude, ChatGPT, Grok, Cursor en Claude Code maken verbinding door via OAuth in te loggen bij Mage. Een API-sleutel is optioneel, voor headless opstellingen zoals CI.
Hoeveel kost de Mage API?
Er is geen abonnement of maandelijks bedrag. Elke generatie betaal je in Gems tegen de vermelde prijs van het model, en 1.000 Gems kosten $1 met het standaardpakket. Op elke modelpagina staat de prijs met standaardinstellingen en elke respons toont de exacte kosten. Een mislukte generatie wordt terugbetaald; een generatie die door het contentbeleid van Mage wordt geblokkeerd niet. Een aanvraag die je saldo niet dekt, wordt geweigerd voordat er iets in rekening wordt gebracht.
Heb ik een Mage-lidmaatschap nodig om de API te gebruiken?
Nee. De API werkt alleen met Gems. Abonnementen en de onbeperkte generaties in de app gelden niet voor API-verzoeken. Je account heeft eerst één geslaagde betaling nodig, een willekeurig Gem-pakket of abonnement. Welkomstbonus-Gems werken alleen in de Mage-app.
Mag ik API-uitvoer commercieel gebruiken?
Ja. Content die je met Mage maakt, ook via de API en de MCP-server, mag je commercieel gebruiken. Naamsvermelding wordt gewaardeerd, maar is niet verplicht.
Wat zijn de rate limits?
Een account kan 20 generaties tegelijk in de wachtrij hebben of laten lopen. Een aanvraag daarboven wordt geweigerd met een 429 en kost niets. Mail naar [email protected] om de limiet te verhogen voor jouw toepassing.
Kan mijn AI-agent de Mage API gebruiken?
Ja. Agents kunnen de REST API aanroepen met een sleutel, of verbinden met de Mage MCP-server, die Claude, ChatGPT, Claude Code, Grok en Cursor zestien kant-en-klare tools geeft om een model te kiezen, de prijs op te vragen, te genereren en het resultaat op te halen. Zie de MCP-server.
Is er een SDK voor de Mage API?
Ja. De officiële pakketten @mage-space/sdk op npm en mage-space op PyPI zijn open source en getypeerd voor elk model. Ze dienen aanvragen in, wachten op het resultaat, proberen veilig opnieuw en uploaden bestanden voor je. ComfyUI-gebruikers kunnen het nodepakket comfyui-mage installeren. Zie de Mage SDK's.
Ik gebruik al een andere generatie-API. Wat moet ik wijzigen?
Richt je client op https://api.mage.space/v1, stuur je Mage-sleutel mee als Bearer-token en koppel je velden aan de modelpagina: prompt, aspect_ratio, resolution, duration en model_id werken bij elk Mage-model hetzelfde. Aanvragen zijn asynchroon, dus dien eerst in en poll daarna status_url.

Begin met bouwen met Mage

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

CharactersCommunity