Mage API · Videogenerierung
Die API für KI-Videogenerierung aus Text oder Bildern
Text-zu-Video, Bild-zu-Video, Start- und Endframe sowie Referenz-zu-Video mit 15 Modellen, angeführt vom Mage-Flaggschiff Cherry 2 Pro, bei vielen Clips mit Audio.
POST https://api.mage.space/v1/{model}/generateAuf einen Blick
Die Mage Video-Generierungs-API ist eine REST-API unter https://api.mage.space/v1, die 15 Text-zu-Video- und Bild-zu-Video-Modelle ausführt, darunter Cherry 2 Pro, Lemon, Plum, Melon, MiniMax-H3, Grok Video und Wan. Sende einen Prompt und optional Frames oder Referenzen, frage die Anfrage per Polling ab und lade ein MP4 herunter. Jeder Clip wird in Gems bezahlt, abhängig von Modell, Auflösung und Dauer.
- 15Videomodelle
- $0.02Günstigster Standard, pro Clip
- 20Parallele Generierungen
- $0Monatliche Gebühr
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.
| Modell | Ideal für | model_id-Werte | Standardpreis |
|---|---|---|---|
| Berry | Video, das deinen Referenzen treu bleibt | berry, berry-2 | 189 Gems ($0.189) |
| Blueberry | Lege den ersten und letzten Frame fest | blueberry, blueberry-v2 | 360 Gems ($0.36) |
| Cherry | Unsere Flaggschiff-Videofamilie | cherry-mini, cherry, cherry-pro, cherry-2, cherry-2-pro | 618 Gems ($0.618) |
| Grok Video | Grok Imagine in Bewegung | grok-imagine-video | 375 Gems ($0.375) |
| Kiwi | Video für jeden Tag, ohne Einrichtung | kiwi | 270 Gems ($0.27) |
| Lemon | Alle Video-Features zu einem fairen Preis | lemon | 245 Gems ($0.245) |
| LTX Video | Schnelles Open-Weights-Video zum Iterieren | ltx-video-096-distilled, ltx-video-096-dev | 20 Gems ($0.02) |
| Magejutsu | Gestalte jedes Video neu und behalte die Bewegung bei | magejutsu, magejutsu-lite, magejutsu-feather | 1,856 Gems ($1.856) |
| Melon | Anime in Bewegung, optional mit Audio | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | Schnelles offenes Video mit Stereoton | minimax-h3-turbo, pika-h3-flex, minimax-h3 | 45 Gems ($0.045) |
| Plum | Ton bei jedem Clip, bis zu 2K | plum, plum-max, plum-fast | 173 Gems ($0.173) |
| Raspberry | Figuren erwachen ab dem ersten Frame zum Leben | raspberry | 360 Gems ($0.36) |
| Seedance | Seedance, mit strengem Filter | seedance-2.0-mini, seedance-2.0-fast, seedance-2.0, seedance-2.5-flash, seedance-2.5 | 618 Gems ($0.618) |
| Wan 3.0 | Wan 3.0, mit strengem Filter | wan-3.0 | 245 Gems ($0.245) |
| Wan Video v2.2 | Open-Weights-Video mit Lightning-Variante | wan22-video, wan22-video-lightning | 40 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.
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.
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.
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
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.
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?
Unterstützt die Video-API Bild-zu-Video?
Wie lang können erzeugte Videos sein?
Wie lange dauert die Erzeugung eines Videos?
Was kostet die Mage API?
Brauche ich eine Mage-Mitgliedschaft, um die API zu nutzen?
Kann ich API-Ergebnisse kommerziell nutzen?
Welche Rate Limits gibt es?
Kann mein KI-Agent die Mage API nutzen?
Gibt es ein SDK für die Mage API?
Ich nutze bereits eine andere Generierungs-API. Was muss ich ändern?
Starte jetzt mit Mage
Ein Konto, ein Gems-Guthaben, alle Modelle. Du zahlst nur für das, was du generierst.