Mage API · Video modeli
Magejutsu API
Herhangi bir videoyu hareketini koruyarak yeniden oluştur
POST https://api.mage.space/v1/magejutsu/generateBir bakışta
Magejutsu API, Magejutsu ve 2 diğer varyantı Mage üzerinden POST https://api.mage.space/v1/magejutsu/generate ile çalıştırır. Varsayılan ayarlarla bir istek 1.856 Gems (yaklaşık $1,856) tutar, abonelik gerekmez. Magejutsu, kayıtlı karakterleri ve istemde @handle ile verilen referansları kabul eder.
- VideoÇıktı
- 3Varyantlar
- 1,856Klip başına Gems, varsayılan
- $1.856Yaklaşık, USD
Genel bakış
Magejutsu API ne yapar?
Elindeki bir videoyu yeniden oluşturur: klibi ve yerine geçecek kişi ya da nesnenin fotoğraflarını gönder; hareket, kamera, zamanlama ve ses çekildiği gibi kalır. Kaynak videolar 4 ila 30 saniye olabilir.
Mevcut bir videoyu yeniden oluşturur: bir yönetmen kaynağa göre düzenleme prompt'unu yazar, bir video düzenleme adımı da sahnede kimin ve neyin yer alacağını baştan kurar. Kaynak videoyu ve yerine geçecek referansları gönder; çıktı kaynağın süresini, oranını, hareketini ve sesini korur.
Girdi olarak image, additional_images ve videos kabul eder.
Hızlı başlangıç
Magejutsu API'yi çağır
MAGE_API_KEY'i ayarla, isteği /magejutsu/generate adresine gönder ve istek tamamlanana kadar status_url'yi sorgula.
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"])Modeller
Magejutsu model_id değerleri
Bir varyant seçmek için model_id gönder. model_id olmadan gönderilen istek varsayılanı çalıştırır.
| model_id | Ad | Varsayılan |
|---|---|---|
| magejutsu | Magejutsu | Evet |
| magejutsu-lite | Magejutsu Lite | |
| magejutsu-feather | Magejutsu Feather |
Seçenekler
Magejutsu parametreleri
Tüm varyantlar için geçerli değerler; bir varyant daha azını sunabilir. Dokümanlar seçenekleri varyant bazında listeler.
| Alan | Değerler |
|---|---|
| resolution | 480p, 720p, 1080p |
| mode | motion_transfer, object_swap |
Girdiler
Magejutsu'nun kabul ettiği medya girdileri
Her birini https URL'si, data URL'si veya en fazla 100 MB'lık bir yükleme olarak gönder.
| Alan | Rol |
|---|---|
| image | Referans görsel. |
| additional_images | Ek referans görseller. |
| videos | Kaynak videolar. |
Kurallar
Magejutsu API'nin uyguladığı kurallar
- Kaynak video, magejutsu'da 4 ile 30 saniye arasında, daha hızlı ve daha ucuz sürüm olan magejutsu-lite'ta ise 4 ile 15 saniye arasında olabilir. En ucuz ve en hızlı model olan magejutsu-feather'da da aynı 4-15 saniye sınırı geçerlidir; bu model yalnızca motion_transfer çalıştırır ve 480p ile 720p çözünürlükte çıktı verir. Çıktı, kaynağın uzunluğunu ve en boy oranını korur.
- Her istek arka planda aynı yönetmen tarafından işlenir. Performans sergileyenleri yeniden oluşturup hareketi korumak için motion_transfer, seçili öğeleri değiştirip çekimin geri kalanını olduğu gibi bırakmak için object_swap seçeneğini kullan. Mod, kaynağın nasıl hazırlanacağını da belirler: motion_transfer, düzenlemeyi değiştirilen her oyuncunun hareketi ve yüzüyle yönlendirir; object_swap ise kaynağı çekildiği haliyle düzenler. Yönlendirmenin okuyamadığı bir klip, örneğin içinde kimsenin olmadığı bir klip, kaynak çekildiği haliyle işlenir. Manuel onay adımı ya da taslak render yoktur.
- image ve additional_images üzerinden en fazla 30 referans görsel gönder. Yönetmen hepsini okur, düzenleme ise prompt'unun kullandıklarını alır: magejutsu'da en fazla 27, magejutsu-lite'ta 9, magejutsu-feather'da 8.
- Prompt isteğe bağlıdır: prompt yoksa yönetmen referansları öne çıkma ve uyum durumuna göre kaynakla eşleştirir.
- Orijinal ses varsayılan olarak geri yüklenir; oluşturulan sesi korumak için keep_original_audio değerini false yap.
- Görseller yerine geçecek öğelerdir; prompt içinde her birinden konumuna göre bahset (“1. görsel soldaki kişi”).
- Bir istekte yalnızca kaynak video kabul edilir; daha uzun klip kırpılmaz, reddedilir.
Diğer video modelleri
Mage'deki diğer yapay zeka video oluşturma API'leri
Melon API
Hareket halinde anime, isteğe bağlı sesle
MiniMax-H3 API
Stereo sesli hızlı açık video modeli
Plum API
Her klipte ses, 2K'ya kadar
Raspberry API
İlk kareden canlanan karakterler
Wan Video v2.2 API
Lightning varyantlı açık ağırlıklı video modeli
Berry API
Referanslarına sadık kalan video
SSS
Sık sorulan sorular
Magejutsu API ne kadar tutar?
Magejutsu API uç noktası nedir?
Hangi Magejutsu modellerini çağırabilirim?
Magejutsu referans görsellerini veya karakterleri destekliyor mu?
Magejutsu'yu Claude veya ChatGPT üzerinden kullanabilir miyim?
Magejutsu sonuçları ne kadar süre saklanır?
Mage ile geliştirmeye başla
Tek hesap, tek Gems bakiyesi, tüm modeller. Yalnızca ürettiğin kadar öde.