Zum Inhalt springen

Mage API · Gemacht für deine nächste Idee

Eine API. Unendlich viele Möglichkeiten.

Bring das Beste von Mage in dein Produkt und zu deinem KI-Assistenten. Erstelle Bilder, Videos und Audio mit nur einem API-Schlüssel oder einer einzigen MCP-Verbindung.

https://api.mage.space/v1

Auf einen Blick

Mage bietet Entwicklern eine REST-API unter https://api.mage.space/v1 und einen Remote-MCP-Server unter https://mcp.mage.space/mcp. Beide nutzen dieselben 37 Bild-, Video- und Audiomodelle, darunter die exklusiv bei Mage verfügbaren Mango 4 und Cherry 2 Pro, mit nur einem Konto. Jede Generierung wird in Gems bezahlt, ganz ohne Abo.

  • 37Modelle
  • 3Medientypen
  • 16MCP-Tools
  • $0Monatliche Gebühr

Deine Einstiege

Nutze es per Code, mit deinem Assistenten oder in ComfyUI

  • REST-API

    Die Mage API

    Sende Generierungen mit einem Schlüssel direkt aus deinem eigenen Code. Asynchrone Anfragen, idempotente Wiederholungen, Uploads bis 100 MB und 20 gleichzeitige Generierungen.

  • SDKs

    TypeScript- und Python-SDKs

    Offizielle, typisierte Clients, die in wenigen Zeilen senden, auf das Ergebnis warten, sicher wiederholen und Dateien hochladen.

  • MCP-Server

    Der Mage MCP-Server

    Verbinde Claude, ChatGPT, Claude Code, Grok oder Cursor per Anmeldung und frag in einfachen Worten nach Bildern, Videos und Audio.

  • ComfyUI

    Mage für ComfyUI

    Mango, Cherry, Seed Audio und alle anderen Mage-Modelle als ComfyUI-Nodes. Ohne GPU, ohne Modell-Downloads.

Nach Medientyp

Generierungs-APIs

Schnellstart

Deine erste Generierung

Erstelle unter API → API Keys einen Schlüssel, exportiere ihn als MAGE_API_KEY und führe eines dieser Beispiele aus.

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"])

So funktioniert's

Vom API-Schlüssel zum fertigen Medium in drei Aufrufen

Alle Modelle teilen sich ein Authentifizierungsschema, einen asynchronen Anfrageablauf und dieselben Feldnamen.

  1. API-Schlüssel erstellen

    Melde dich bei Mage an, öffne API → API Keys und erstelle einen Schlüssel. Er beginnt mit mage_sk_ und wird nur einmal angezeigt. Ein Konto kann 10 aktive Schlüssel haben.

  2. Generierung senden

    Sende per POST einen JSON-Body an https://api.mage.space/v1/{model}/generate, mit einem Authorization: Bearer-Header. Die Antwort kommt sofort und enthält eine request_id, einen status und eine status_url. Sende einen Idempotency-Key-Header, damit eine Wiederholung nie doppelt kostet.

  3. Abfragen und herunterladen

    Frage die status_url ab, bis der Status completed, failed oder cancelled ist. Eine abgeschlossene Anfrage enthält result.url mit der Bild-, Video- oder Audiodatei, die 30 Tage lang gespeichert bleibt.

MCP

Mage in deinem KI-Assistenten

  • Mage in Claude

    Erstelle Bilder, Videos und Audio in Claude im Web, in der Desktop-App, in den mobilen Apps und in Cowork.

  • Mage in ChatGPT

    Erstelle Bilder, Videos und Audio in ChatGPT als persönliche MCP-App.

  • Mage in Claude Code

    Erstelle Bilder, Videos und Audio in Claude Code, in deinem Terminal und Editor.

  • Mage in Grok

    Erstelle Bilder, Videos und Audio in Grok als benutzerdefinierten Connector.

  • Mage in Cursor

    Erstelle Bilder, Videos und Audio im Agent-Modus von Cursor.

Modelle

Ausgewählte Modelle

  • Bild · ab 40 Gems

    Flux 2 API

    Lange Prompts und Bearbeitungen mit mehreren Referenzen

  • Bild · ab 9 Gems

    GPT Image 2 API

    Präzise Prompts und lesbarer Text

  • Bild · ab 37 Gems

    Guava API

    Fotorealismus, der als Foto durchgeht

  • Bild · ab 42 Gems

    Mango API

    Unsere Flaggschiff-Bildfamilie

  • Bild · ab 51 Gems

    Nano Banana 2 API

    Gestochen scharfer, lesbarer Text, bis zu 4K

  • Video · ab 618 Gems

    Cherry API

    Unsere Flaggschiff-Videofamilie

  • Video · ab 245 Gems

    Lemon API

    Alle Video-Funktionen zu einem fairen Preis

  • Video · ab 173 Gems

    Plum API

    Ton in jedem Clip, bis zu 2K

  • Audio · ab 19 Gems

    Seed Audio API

    Stimmen, Musik und Soundeffekte aus einem Prompt

Für den Produktiveinsatz gebaut

Das bekommt jede Anfrage an die Mage API

  • Ein Schlüssel, alle Modelle

    37 Bild-, Video- und Audiomodelle hinter einer REST-API und einem Gems-Guthaben. Wechsle das Modell, indem du den URL-Pfad änderst.

  • Zahlung pro Generierung

    Kein Abo und kein Mindestumsatz. Du kaufst Gems, und jede Anfrage kostet ihren angegebenen Preis. Eine fehlgeschlagene Generierung wird erstattet, es sei denn, die Inhaltsrichtlinie von Mage hat sie blockiert.

  • Sichere Wiederholungen

    Mit Idempotency-Keys liefert ein erneut gesendeter Request die ursprüngliche Anfrage zurück, ohne erneut abzurechnen.

  • Konsistente Charaktere

    Speichere einen Charakter oder eine Referenz einmal und schreibe dann @handle in einen beliebigen Prompt, um sie mit jedem unterstützten Modell zu verwenden.

  • Große Eingaben

    Sende Bild-, Video- und Audioeingaben als URLs oder Data-URLs oder lade Dateien bis 100 MB über einen signierten Upload hoch.

  • 20 Generierungen gleichzeitig

    Jedes Konto kann 20 Generierungen gleichzeitig ausführen, und das Limit lässt sich für deinen Anwendungsfall erhöhen. Abgelehnte Anfragen werden nie berechnet.

FAQ

Häufig gestellte Fragen

Was ist die Mage API?
Die Mage API ist eine REST-API unter https://api.mage.space/v1, mit der du in deinem eigenen Code Bilder, Videos und Audio mit 37 Modellen generieren kannst. Anfragen laufen asynchron und werden pro Generierung in Gems bezahlt.
Was ist der Mage MCP-Server?
Ein Remote-Server für das Model Context Protocol unter https://mcp.mage.space/mcp, mit dem KI-Assistenten Bilder, Videos und Audio in deinem Mage-Konto generieren können. Er gibt dem Assistenten 16 Tools, um ein Modell auszuwählen, den Preis abzufragen, zu generieren, auf das Ergebnis zu warten und deine gespeicherten Charaktere, Referenzen und deinen Verlauf zu nutzen.
Brauche ich einen API-Schlüssel, um den MCP-Server zu nutzen?
Nein. Claude, ChatGPT, Grok, Cursor und Claude Code verbinden sich, indem du dich per OAuth bei Mage anmeldest. Ein API-Schlüssel ist optional, z. B. für Headless-Setups wie CI.
Was kostet die Mage API?
Es gibt kein Abo und keine monatliche Gebühr. Jede Generierung wird in Gems zum angegebenen Preis des Modells bezahlt, und 1.000 Gems kosten im Standardpaket 1 $. Jede Modellseite nennt den Preis bei Standardeinstellungen, und jede Antwort enthält die genaue Abrechnung. Eine fehlgeschlagene Generierung wird erstattet; eine, die von der Inhaltsrichtlinie von Mage blockiert wird, nicht. Eine Anfrage, die dein Guthaben nicht deckt, wird abgelehnt, bevor etwas berechnet wird.
Brauche ich eine Mage-Mitgliedschaft, um die API zu nutzen?
Nein. Die API läuft ausschließlich über Gems. Mitgliedschaftspläne und die damit verbundene unbegrenzte Generierung in der App gelten nicht für API-Anfragen. Für dein Konto ist zuerst eine erfolgreiche Zahlung nötig, egal ob ein Gem-Paket oder ein Plan. Gems aus dem Anmeldebonus funktionieren nur in der Mage-App.
Kann ich API-Ergebnisse kommerziell nutzen?
Ja. Inhalte, die du mit Mage erstellst, auch über die API und den MCP-Server, kannst du kommerziell nutzen. Eine Namensnennung freut uns, ist aber nicht erforderlich.
Welche Rate Limits gibt es?
Ein Account kann 20 Generierungen gleichzeitig in der Warteschlange haben oder ausführen. Jede weitere Anfrage wird mit 429 abgelehnt und kostet nichts. Schreib an [email protected], um das Limit für deinen Anwendungsfall zu erhöhen.
Kann mein KI-Agent die Mage API nutzen?
Ja. Agenten können die REST-API mit einem Key aufrufen oder sich mit dem Mage MCP-Server verbinden. Er gibt Claude, ChatGPT, Claude Code, Grok und Cursor sechzehn fertige Tools an die Hand, um ein Modell auszuwählen, den Preis abzufragen, zu generieren und das Ergebnis abzurufen. Siehe den MCP-Server.
Gibt es ein SDK für die Mage API?
Ja. Das offizielle Paket @mage-space/sdk auf npm und mage-space auf PyPI sind Open Source und für jedes Modell typisiert. Sie senden Anfragen, warten auf das Ergebnis, wiederholen Anfragen sicher und laden Dateien für dich hoch. Wer ComfyUI nutzt, kann das Node-Pack comfyui-mage installieren. Siehe die Mage SDKs.
Ich nutze bereits eine andere Generierungs-API. Was muss ich ändern?
Richte deinen Client auf https://api.mage.space/v1 aus, sende deinen Mage Key als Bearer-Token und ordne deine Felder der Modellseite zu: prompt, aspect_ratio, resolution, duration und model_id funktionieren bei jedem Mage Modell gleich. Anfragen laufen asynchron: Sende sie ab und frage dann status_url ab.

Starte jetzt mit Mage

Ein Konto, ein Gems-Guthaben, alle Modelle. Du zahlst nur für das, was du generierst.

CharactersCommunity