Przejdź do treści
PlaygroundDokumentacjaZdobądź klucz API

Mage API · Model wideo

Magejutsu API

Zmień obsadę dowolnego wideo, zachowując jego ruch

Zdobądź klucz APIWypróbuj Magejutsu w playgroundzie
POST https://api.mage.space/v1/magejutsu/generate

W skrócie

API Magejutsu uruchamia Magejutsu i 2 inne warianty przez Mage pod adresem POST https://api.mage.space/v1/magejutsu/generate. Zapytanie z ustawieniami domyślnymi kosztuje 1856 Gems (ok. 1,856 USD), bez subskrypcji. Magejutsu obsługuje zapisane postacie i odniesienia przez @handle w prompcie.

  • WideoWynik
  • 3Warianty
  • 1,856Gems za klip, domyślnie
  • $1.856Około, w USD

Przegląd

Co robi Magejutsu API

Zmienia obsadę istniejącego wideo: wysyłasz klip i zdjęcia osoby lub rzeczy, która ma zastąpić oryginał, a ruch, kamera, tempo i dźwięk zostają takie, jak nagrano. Materiał źródłowy trwa od 4 do 30 sekund.

Zmienia obsadę istniejącego wideo: reżyser pisze prompt edycji na podstawie źródła, a etap edycji wideo odtwarza to, kto i co w nim występuje. Wysyłasz wideo źródłowe i referencje zastępujące, a wynik zachowuje długość, proporcje, ruch i dźwięk źródła.

Przyjmuje jako dane wejściowe: image, additional_images, videos.

Szybki start

Wywołaj Magejutsu API

Ustaw MAGE_API_KEY, wyślij żądanie do /magejutsu/generate i odpytuj status_url, aż żądanie się zakończy.

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

Modele

Wartości model_id dla Magejutsu

Wyślij model_id, aby wybrać wariant. Zapytanie bez niego użyje wariantu domyślnego.

model_idNazwaDomyślny
magejutsuMagejutsuTak
magejutsu-liteMagejutsu Lite
magejutsu-featherMagejutsu Feather

Opcje

Parametry Magejutsu

Dozwolone wartości dla wszystkich wariantów; dany wariant może oferować mniej. Opcje dla poszczególnych wariantów znajdziesz w dokumentacji.

PoleWartości
resolution480p, 720p, 1080p
modemotion_transfer, object_swap

Dane wejściowe

Pliki multimedialne akceptowane przez Magejutsu

Każdy wyślij jako URL https, data URL lub plik o rozmiarze do 100 MB.

PoleRola
imageObraz referencyjny.
additional_imagesDodatkowe obrazy referencyjne.
videosWideo źródłowe.

Zasady

Jakie ograniczenia egzekwuje Magejutsu API

  • Film źródłowy może trwać od 4 do 30 sekund w magejutsu oraz od 4 do 15 w magejutsu-lite, czyli szybszym i tańszym wariancie, a także w magejutsu-feather, najtańszym i najszybszym, który obsługuje tylko motion_transfer i renderuje w 480p i 720p. Wynik ma taką samą długość i proporcje obrazu jak źródło.
  • Każde zapytanie uruchamia tego samego reżysera w backendzie. Wybierz motion_transfer, aby odtworzyć wykonawców i zachować ruch, albo object_swap, aby zmienić wybrane elementy i zostawić resztę ujęcia bez zmian. Tryb decyduje też o tym, jak przygotowywane jest źródło: motion transfer prowadzi edycję na podstawie ruchu i twarzy każdego zastępowanego wykonawcy, a object swap edytuje źródło w takiej postaci, w jakiej zostało nagrane. Klip, którego wskazówki nie potrafią odczytać, na przykład taki bez żadnej osoby, jest renderowany na podstawie źródła w oryginalnej postaci. Nie ma ręcznych kroków zatwierdzania ani wersji roboczych renderów.
  • Możesz wysłać do 30 obrazów referencyjnych w polach image i additional_images. Reżyser analizuje każdy z nich, a edycja otrzymuje te, których użyto w prompcie: do 27 w magejutsu, 9 w magejutsu-lite i 8 w magejutsu-feather.
  • Prompt jest opcjonalny: jeśli go nie podasz, reżyser dopasuje referencje do źródła na podstawie ich wyrazistości i dopasowania.
  • Oryginalny dźwięk jest domyślnie przywracany; ustaw keep_original_audio na false, aby zachować wygenerowany dźwięk.
  • Obrazy stanowią zastępstwo. W prompcie odwołuj się do każdego według pozycji („obraz 1 to osoba po lewej”).
  • W jednym żądaniu można przesłać tylko wideo źródłowe. Dłuższy klip zostanie odrzucony, a nie przycięty.

Więcej modeli wideo

Inne API do generowania wideo w Mage

  • Wideo · od 147 Gems

    Melon API

    Anime w ruchu, opcjonalnie z dźwiękiem

  • Wideo · od 30 Gems

    MiniMax-H3 API

    Szybkie otwarte wideo z dźwiękiem stereo

  • Wideo · od 173 Gems

    Plum API

    Dźwięk w każdym klipie, do 2K

  • Wideo · od 360 Gems

    Raspberry API

    Postacie ożywione z pierwszej klatki

  • Wideo · od 40 Gems

    Wan Video v2.2 API

    Wideo z otwartymi wagami i wariantem Lightning

  • Wideo · od 189 Gems

    Berry API

    Wideo wierne Twoim referencjom

FAQ

Najczęściej zadawane pytania

Ile kosztuje Magejutsu API?
Zapytanie Magejutsu z ustawieniami domyślnymi (Magejutsu) kosztuje 1856 Gems, czyli ok. 1,856 $. Inne rozdzielczości, czasy trwania i warianty zmieniają cenę, a dokładną kwotę znajdziesz w odpowiedzi. Za nieudane generowanie zwracamy koszt, ale nie za takie, które zablokuje polityka treści Mage.
Jaki jest endpoint Magejutsu API?
POST https://api.mage.space/v1/magejutsu/generate z nagłówkiem Authorization: Bearer zawierającym twój klucz API Mage. Odpowiedź zawiera status_url, który odpytujesz, aby pobrać wynik.
Które modele Magejutsu mogę wywołać?
magejutsu (Magejutsu), magejutsu-lite (Magejutsu Lite), magejutsu-feather (Magejutsu Feather). Domyślnie używany jest Magejutsu.
Czy Magejutsu obsługuje obrazy referencyjne lub postacie?
Magejutsu przyjmuje image, additional_images, videos. Magejutsu obsługuje zapisane postacie i referencje przez @handle w prompcie.
Czy mogę używać Magejutsu w Claude lub ChatGPT?
Tak. Połącz serwer MCP Mage z Claude, ChatGPT, Claude Code, Grok lub Cursor i poproś o Magejutsu po nazwie. Asystent odczyta opcje przez get_model i poda cenę przed generowaniem.
Jak długo przechowywane są wyniki Magejutsu?
Wyniki i dane wejściowe są przechowywane przez 30 dni. Wszystko, co chcesz zachować, pobierz na własny dysk.

Zacznij tworzyć z Mage

Jedno konto, jedno saldo Gems, wszystkie modele. Płacisz tylko za to, co wygenerujesz.

Zdobądź klucz APIWypróbuj Magejutsu w playgroundzie