Mage API · Videomodell
Magejutsu API
Gestalte jedes Video neu und behalte die Bewegung bei
POST https://api.mage.space/v1/magejutsu/generateAuf einen Blick
Die Magejutsu API führt Magejutsu und 2 weitere Varianten über Mage aus, und zwar unter POST https://api.mage.space/v1/magejutsu/generate. Eine Anfrage mit den Standardeinstellungen kostet 1.856 Gems (etwa 1,856 $), ohne Abo. Magejutsu akzeptiert gespeicherte Characters und Referenzen per @handle im Prompt.
- VideoAusgabe
- 3Varianten
- 1,856Gems pro Clip, Standard
- $1.856Ca. in USD
Überblick
Was die Magejutsu API kann
Gestaltet ein vorhandenes Video neu: Sende den Clip und Fotos von dem, wer oder was ersetzt werden soll. Bewegung, Kamera, Timing und Ton bleiben wie gefilmt. Die Quellvideos dürfen 4 bis 30 Sekunden lang sein.
Gestaltet ein vorhandenes Video neu: Ein Director schreibt den Bearbeitungs-Prompt anhand der Quelle, und ein Video-Edit-Durchlauf baut neu auf, wer und was darin auftritt. Sende das Quellvideo und die Ersatzreferenzen; das Ergebnis behält Länge, Seitenverhältnis, Bewegung und Ton der Quelle bei.
Als Eingaben akzeptiert sie image, additional_images und videos.
Schnellstart
Die Magejutsu API aufrufen
Setze MAGE_API_KEY, sende die Anfrage an /magejutsu/generate und frage status_url ab, bis die Anfrage abgeschlossen ist.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/magejutsu/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",
"videos": [
"https://example.com/input.jpg"
],
"image": "https://example.com/input.jpg",
"model_id": "magejutsu"
}' | 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('magejutsu', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
videos: [
'https://example.com/input.jpg',
],
image: 'https://example.com/input.jpg',
model_id: 'magejutsu',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("magejutsu", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"videos": [
"https://example.com/input.jpg",
],
"image": "https://example.com/input.jpg",
"model_id": "magejutsu",
})
print(request["result"]["url"])Modelle
Magejutsu model_id-Werte
Sende model_id, um eine Variante auszuwählen. Ohne Angabe wird die Standardvariante verwendet.
| model_id | Name | Standard |
|---|---|---|
| magejutsu | Magejutsu | Ja |
| magejutsu-lite | Magejutsu Lite | |
| magejutsu-feather | Magejutsu Feather |
Optionen
Magejutsu-Parameter
Zulässige Werte über alle Varianten hinweg; eine Variante kann weniger anbieten. Die Optionen pro Variante findest du in der Dokumentation.
| Feld | Werte |
|---|---|
| resolution | 480p, 720p, 1080p |
| mode | motion_transfer, object_swap |
Eingaben
Medien-Eingaben, die Magejutsu akzeptiert
Sende jede Eingabe als https-URL, als Data-URL oder als Upload mit bis zu 100 MB.
| Feld | Rolle |
|---|---|
| image | Das Referenzbild. |
| additional_images | Weitere Referenzbilder. |
| videos | Die Quellvideos. |
Regeln
Was die Magejutsu API erzwingt
- Das Quellvideo ist bei magejutsu 4 bis 30 Sekunden lang, bei magejutsu-lite 4 bis 15 Sekunden. Das ist die schnellere und günstigere Variante. Das Gleiche gilt für magejutsu-feather, die günstigste und schnellste Variante, die nur motion_transfer unterstützt und in 480p und 720p rendert. Die Ausgabe übernimmt die Länge und das Seitenverhältnis der Quelle.
- Jede Anfrage läuft im Backend über denselben Director. Wähle motion_transfer, um die Darsteller neu aufzubauen und die Bewegung beizubehalten, oder object_swap, um ausgewählte Elemente zu ändern und den Rest der Szene wie gedreht zu belassen. Der Modus bestimmt auch, wie die Quelle vorbereitet wird: Bei einem Motion Transfer steuern die Bewegung und das Gesicht jedes ersetzten Darstellers die Bearbeitung, bei einem Objekttausch wird die Quelle so bearbeitet, wie sie gedreht wurde. Ein Clip, den die Steuerung nicht auswerten kann, etwa weil keine Person darin vorkommt, wird aus der Quelle wie gedreht gerendert. Es gibt weder manuelle Freigabeschritte noch Entwurfs-Renderings.
- Sende bis zu 30 Referenzbilder über image und additional_images. Die Regie liest jedes davon, und die Bearbeitung erhält die Bilder, die dein Prompt verwendet: bis zu 27 bei magejutsu, 9 bei magejutsu-lite und 8 bei magejutsu-feather.
- Der Prompt ist optional: Ohne Prompt ordnet der Director die Referenzen der Quelle nach Auffälligkeit und Passgenauigkeit zu.
- Das Originalaudio wird standardmäßig wiederhergestellt. Setze keep_original_audio auf false, um das generierte Audio beizubehalten.
- Die Bilder sind der Ersatz; nenne jedes im Prompt mit seiner Position („Bild 1 ist die Person links“).
- Pro Anfrage wird nur das Quellvideo akzeptiert; ein längerer Clip wird abgelehnt statt gekürzt.
Weitere Videomodelle
Weitere APIs zur Videogenerierung auf Mage
Melon-API
Anime in Bewegung, optional mit Audio
MiniMax-H3 API
Schnelles offenes Video mit Stereoton
Plum API
Ton in jedem Clip, bis zu 2K
Raspberry API
Characters, die aus einem ersten Frame zum Leben erwachen
Wan Video v2.2 API
Video mit offenen Gewichten und einer Lightning-Variante
Berry API
Video, das deinen Referenzen treu bleibt
FAQ
Häufig gestellte Fragen
Was kostet die Magejutsu API?
Wie lautet der Endpunkt der Magejutsu API?
Welche Magejutsu-Modelle kann ich aufrufen?
Unterstützt Magejutsu Referenzbilder oder Characters?
Kann ich Magejutsu in Claude oder ChatGPT nutzen?
Wie lange werden Magejutsu-Ergebnisse gespeichert?
Starte jetzt mit Mage
Ein Konto, ein Gems-Guthaben, alle Modelle. Du zahlst nur für das, was du generierst.