Mage API · Videogenerierung

Die API für KI-Videogenerierung aus Text oder Bildern

Text-zu-Video, Bild-zu-Video, Erster-und-letzter-Frame und Referenz-zu-Video mit 12 Modellen, angeführt von Mages Flaggschiff Cherry 2 Pro, bei vielen Clips mit Audio.

API-Schlüssel holenAPI-Dokumentation lesen
POST https://api.mage.space/v1/{model}/generate

Auf einen Blick

Die Mage Video-API ist eine REST-API unter https://api.mage.space/v1, über die 12 Text-zu-Video- und Bild-zu-Video-Modelle laufen, darunter Cherry 2 Pro, Lemon, Plum, Melon, MiniMax-H3, Grok Video und Wan. Sende einen Prompt und optional Frames oder Referenzen, frage die Anfrage ab und lade ein MP4 herunter. Jeder Clip wird in Gems bezahlt, abhängig von Modell, Auflösung und Dauer.

Modelle

Alle Videomodelle in der Mage API

Die Preise gelten pro Generierung, in Gems. 1.000 Gems kosten im Standardpaket 1 $, größere Pakete enthalten Bonus-Gems. Der Preis hängt von Modell, Auflösung und Dauer ab; angezeigt wird der Preis bei Standardeinstellungen, und jede Antwort nennt die genaue Abbuchung in billing.gems_charged. Eine fehlgeschlagene Generierung wird erstattet, eine von der Inhaltsrichtlinie von Mage blockierte nicht.

ModellIdeal fürmodel_id-WerteStandardpreis
BerryVideo, das deinen Referenzen treu bleibtberry, berry-2189 Gems ($0.189)
BlueberryLege den ersten und letzten Frame festblueberry, blueberry-v2360 Gems ($0.36)
CherryUnsere Flaggschiff-Videofamiliecherry-mini, cherry, cherry-pro, cherry-2-pro618 Gems ($0.618)
Grok VideoGrok Imagine in Bewegunggrok-imagine-video375 Gems ($0.375)
KiwiVideo für jeden Tag, ohne Einrichtungkiwi270 Gems ($0.27)
LemonAlle Video-Features zu einem fairen Preislemon245 Gems ($0.245)
LTX VideoSchnelles Open-Weights-Video zum Iterierenltx-video-096-distilled, ltx-video-096-dev20 Gems ($0.02)
MelonAnime in Bewegung, optional mit Audiomelon, melon-pro147 Gems ($0.147)
MiniMax-H3Schnelles offenes Video mit Stereotonminimax-h3-turbo, minimax-h330 Gems ($0.03)
PlumTon bei jedem Clip, bis zu 2Kplum, plum-max338 Gems ($0.338)
RaspberryFiguren erwachen ab dem ersten Frame zum Lebenraspberry360 Gems ($0.36)
Wan Video v2.2Open-Weights-Video mit Lightning-Variantewan22-video, wan22-video-lightning40 Gems ($0.04)

Schnellstart

Ein Video mit Berry 2 erzeugen

Setze MAGE_API_KEY, sende die Anfrage und frage den Status ab, bis sie abgeschlossen ist. Ersetze berry in der URL durch ein beliebiges Modell oben.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/berry/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
  "aspect_ratio": "16:9",
  "duration": "3",
  "model_id": "berry-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('berry', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '3',
  model_id: 'berry-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("berry", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "3",
    "model_id": "berry-2",
})

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.

Für den Produktiveinsatz gebaut

Das bekommt jede Anfrage an die Mage API

Ein Schlüssel, alle Modelle

28 Bild-, Video- und Audiomodelle über eine REST-API und ein 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.

Anwendungsfälle

Was Entwickler mit der Video-API bauen

Kurzvideos und Social Video

Erstelle Hochformat-Clips für TikTok, Reels und Shorts aus einem Prompt oder einem Produktbild.

Standbilder animieren

Verwandle einen ersten Frame oder einen ersten und letzten Frame mit Bild-zu-Video-Modellen wie Lemon und Kiwi in Bewegung.

Geschichten rund um Figuren

Behalte dieselbe Figur über mehrere Einstellungen hinweg mit Referenz-zu-Video-Modellen, die @handle-Characters unterstützen.

Video mit Ton

Plum und andere Modelle erzeugen Sprache, Soundeffekte und Atmosphäre passend zum Bild und akzeptieren Audio-Referenzen für Stimmen.

Werbung und Produktdemos

Erzeuge viele Varianten eines Spots und wähle die beste aus – mit idempotenten Anfragen, die nie doppelt abgerechnet werden.

Vorhandene Clips bearbeiten

Berry, Plum und Grok Video bearbeiten ein von dir gesendetes Quellvideo; Lemon und MiniMax-H3 akzeptieren außerdem Referenzvideos.

FAQ

Häufig gestellte Fragen

Was ist die beste API zur KI-Videogenerierung?

Bei Mage ist Cherry 2 Pro die Standardwahl für Video: Es unterstützt Characters, viele Referenzbilder, Audio-Referenzen, Ausgabe von 480p bis 1080p und Clips bis zu 30 Sekunden. Lemon ist die Wahl für die Steuerung per erstem und letztem Frame, Plum für Clips mit erzeugtem Ton bis 2K und Cherry Mini oder Wan für günstigere Entwürfe.

Unterstützt die Video-API Bild-zu-Video?

Ja. Bild-zu-Video-Modelle akzeptieren einen ersten Frame, manche auch einen letzten Frame oder Referenzbilder, als URLs, Data-URLs oder Uploads. Auf der Seite jedes Modells siehst du die Eingaben und ob ein Bild erforderlich ist.

Wie lang können erzeugte Videos sein?

Das hängt vom Modell und der Auflösung ab. Viele Modelle erzeugen 4 bis 15 Sekunden, Cherry 2 Pro schafft 20, 25 und 30 Sekunden. Auf der Seite jedes Modells findest du die möglichen Längen.

Wie lange dauert die Erzeugung eines Videos?

Das hängt vom Modell, der Auflösung und der Dauer ab. Die API arbeitet asynchron: Sende die Anfrage und frage dann status_url mit Backoff ab, oder lass deinen MCP-Client mit get_request warten.

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. Mitgliedschaften und ihre unbegrenzten Generierungen in der App gelten nicht für API-Anfragen, daher kann jedes Mage-Konto mit Gems sie nutzen.

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.

API-Schlüssel holenAPI-Dokumentation lesen

Ähnliche Inhalte