Langsung ke konten
PlaygroundDokumentasiDapatkan kunci API

Mage API · Model video

Magejutsu API

Ganti subjek video apa pun, gerakannya tetap utuh

Dapatkan kunci APICoba Magejutsu di playground
POST https://api.mage.space/v1/magejutsu/generate

Sekilas info

API Magejutsu menjalankan Magejutsu dan 2 varian lainnya lewat Mage di POST https://api.mage.space/v1/magejutsu/generate. Satu permintaan dengan pengaturan default berharga 1.856 Gems (sekitar $1,856), tanpa langganan. Magejutsu mendukung karakter tersimpan dan referensi lewat @handle di dalam prompt.

  • VideoOutput
  • 3Varian
  • 1,856Gems per klip, default
  • $1.856Perkiraan, dalam USD

Ringkasan

Fungsi Magejutsu API

Mengganti subjek di video yang sudah kamu punya: kirim kliknya beserta foto siapa atau apa yang menggantikan, lalu gerakan, kamera, timing, dan suara tetap seperti saat direkam. Durasi video sumber 4 sampai 30 detik.

Mengganti subjek di video yang sudah ada: seorang sutradara menulis prompt edit dari video sumber, lalu proses video-edit membangun ulang siapa dan apa yang tampil. Kirim video sumber dan referensi pengganti; hasilnya mempertahankan durasi, rasio, gerakan, dan suara video sumber.

Menerima image, additional_images, dan videos sebagai input.

Mulai cepat

Panggil Magejutsu API

Atur MAGE_API_KEY, kirim ke /magejutsu/generate, lalu polling status_url sampai permintaan selesai.

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

Model

Nilai model_id Magejutsu

Kirim model_id untuk memilih varian. Permintaan tanpa model_id akan menjalankan varian default.

model_idNamaDefault
magejutsuMagejutsuYa
magejutsu-liteMagejutsu Lite
magejutsu-featherMagejutsu Feather

Opsi

Parameter Magejutsu

Nilai yang diizinkan untuk semua varian; satu varian bisa menawarkan lebih sedikit. Dokumentasi mencantumkan opsi untuk tiap varian.

KolomNilai
resolution480p, 720p, 1080p
modemotion_transfer, object_swap

Input

Input media yang diterima Magejutsu

Kirim masing-masing sebagai URL https, data URL, atau unggahan hingga 100 MB.

KolomPeran
imageGambar referensi.
additional_imagesGambar referensi tambahan.
videosVideo sumber.

Aturan

Aturan yang diterapkan Magejutsu API

  • Video sumber berdurasi 4 sampai 30 detik di magejutsu, dan 4 sampai 15 detik di magejutsu-lite, varian yang lebih cepat dan lebih murah, serta di magejutsu-feather, yang termurah dan tercepat, yang hanya menjalankan motion_transfer dan merender di 480p dan 720p. Hasilnya mengikuti durasi dan rasio aspek video sumber.
  • Setiap permintaan dijalankan oleh director yang sama di backend. Pilih motion_transfer untuk membangun ulang para pemeran dengan tetap mempertahankan gerakannya, atau object_swap untuk mengubah elemen tertentu dan membiarkan sisa adegan seperti saat direkam. Mode ini juga menentukan cara sumber disiapkan: motion transfer memandu proses edit dengan gerakan dan wajah setiap pemeran yang diganti, sedangkan object_swap mengedit sumber apa adanya seperti saat direkam. Klip yang tidak bisa dibaca oleh panduan tersebut, misalnya klip tanpa orang di dalamnya, dirender dari sumber apa adanya seperti saat direkam. Tidak ada langkah persetujuan manual atau render draf.
  • Kirim hingga 30 gambar referensi lewat image dan additional_images. Sutradara membaca semuanya, dan proses edit menerima gambar yang dipakai di prompt: hingga 27 di magejutsu, 9 di magejutsu-lite, dan 8 di magejutsu-feather.
  • Prompt bersifat opsional: tanpa prompt, director akan memetakan referensi ke sumber berdasarkan seberapa menonjol dan seberapa cocok referensi tersebut.
  • Audio asli dipulihkan secara default; setel keep_original_audio ke false untuk mempertahankan audio yang dihasilkan.
  • Gambar berfungsi sebagai pengganti; sebut tiap gambar di prompt berdasarkan posisinya ("gambar 1 adalah orang di sebelah kiri").
  • Hanya video sumber yang diterima dalam satu permintaan; klip yang lebih panjang ditolak, bukan dipotong.

Model video lainnya

API pembuat video AI lainnya di Mage

  • Video · mulai dari 147 Gems

    Melon API

    Anime dalam gerak, dengan audio opsional

  • Video · mulai dari 30 Gems

    MiniMax-H3 API

    Video open source yang cepat dengan suara stereo

  • Video · mulai dari 173 Gems

    Plum API

    Suara di setiap klip, hingga 2K

  • Video · mulai dari 360 Gems

    Raspberry API

    Karakter yang hidup dari frame pertama

  • Video · mulai dari 40 Gems

    Wan Video v2.2 API

    Video open-weights dengan varian Lightning

  • Video · mulai dari 189 Gems

    Berry API

    Video yang tetap setia pada referensimu

FAQ

Pertanyaan yang sering diajukan

Berapa biaya Magejutsu API?
Satu permintaan Magejutsu dengan pengaturan default (Magejutsu) berharga 1.856 Gems, sekitar $1,856. Resolusi, durasi, dan varian lain memengaruhi harga; biaya pastinya tertera di respons. Generasi yang gagal akan dikembalikan Gems-nya, sedangkan yang diblokir oleh kebijakan konten Mage tidak.
Apa endpoint Magejutsu API?
POST https://api.mage.space/v1/magejutsu/generate dengan header Authorization: Bearer yang berisi kunci API Mage-mu. Respons menyertakan status_url yang di-polling untuk mendapatkan hasilnya.
Model Magejutsu mana yang bisa kupanggil?
magejutsu (Magejutsu), magejutsu-lite (Magejutsu Lite), magejutsu-feather (Magejutsu Feather). Defaultnya adalah Magejutsu.
Apakah Magejutsu mendukung gambar referensi atau karakter?
Magejutsu menerima image, additional_images, videos. Magejutsu mendukung karakter tersimpan dan referensi lewat @handle di prompt.
Bisakah aku memakai Magejutsu dari Claude atau ChatGPT?
Bisa. Hubungkan server MCP Mage ke Claude, ChatGPT, Claude Code, Grok, atau Cursor, lalu minta Magejutsu dengan menyebut namanya. Asistenmu membaca opsinya dengan get_model dan menyebutkan harga sebelum membuat.
Berapa lama hasil Magejutsu disimpan?
Hasil dan input disimpan selama 30 hari. Unduh apa pun yang ingin kamu simpan ke penyimpananmu sendiri.

Mulai berkarya dengan Mage

Satu akun, satu saldo Gems, semua model. Bayar hanya untuk yang kamu buat.

Dapatkan kunci APICoba Magejutsu di playground