Mage API · Video üretimi
Metinden veya görsellerden çalışan yapay zeka video üretim API'si
Mage'in amiral gemisi Cherry 2 Pro öncülüğündeki 15 modelle metinden videoya, görselden videoya, ilk-son kareden videoya ve referanstan videoya; birçok klipte ses de var.
POST https://api.mage.space/v1/{model}/generateBir bakışta
Mage video üretim API'si, https://api.mage.space/v1 adresindeki bir REST API'dir; Cherry 2 Pro, Lemon, Plum, Melon, MiniMax-H3, Grok Video ve Wan dahil 15 metinden videoya ve görselden videoya modelini çalıştırır. Bir prompt ve isteğe bağlı kareler ya da referanslar gönder, isteği sorgula ve MP4 indir. Her klip; modele, çözünürlüğe ve süreye göre Gems ile ödenir.
- 15video modeli
- $0.02En ucuz varsayılan, klip başına
- 20Eşzamanlı üretim
- $0Aylık ücret
Modeller
Mage API'deki tüm video modelleri
Fiyatlar üretim başınadır ve Gems cinsindendir. Standart pakette 1.000 Gems 1 $ eder, daha büyük paketlerde bonus Gems eklenir. Fiyat modele, çözünürlüğe ve süreye göre değişir; burada varsayılan ayarların fiyatı gösterilir ve her yanıt tam ücreti billing.gems_charged alanında bildirir. Başarısız olan üretimin ücreti iade edilir; Mage'in içerik politikası tarafından engellenen üretimin ücreti iade edilmez.
| Model | En uygun kullanım | model_id değerleri | Varsayılan fiyat |
|---|---|---|---|
| Berry | Referanslarına sadık kalan video | berry, berry-2 | 189 Gems ($0.189) |
| Blueberry | İlk ve son kareyi sabitle | blueberry, blueberry-v2 | 360 Gems ($0.36) |
| Cherry | Amiral gemisi video ailemiz | cherry-mini, cherry, cherry-pro, cherry-2, cherry-2-pro | 618 Gems ($0.618) |
| Grok Video | Hareket halinde Grok Imagine | grok-imagine-video | 375 Gems ($0.375) |
| Kiwi | Günlük videolar, sıfır kurulum | kiwi | 270 Gems ($0.27) |
| Lemon | Tüm video özellikleri, daha uygun fiyata | lemon | 245 Gems ($0.245) |
| LTX Video | Denemeler için hızlı, açık ağırlıklı video | ltx-video-096-distilled, ltx-video-096-dev | 20 Gems ($0.02) |
| Magejutsu | Herhangi bir videoyu hareketini koruyarak yeniden oluştur | magejutsu, magejutsu-lite, magejutsu-feather | 1,856 Gems ($1.856) |
| Melon | Hareket halinde anime, isteğe bağlı sesle | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | Stereo sesli hızlı açık video | minimax-h3-turbo, pika-h3-flex, minimax-h3 | 45 Gems ($0.045) |
| Plum | Her klipte ses, 2K'ya kadar | plum, plum-max, plum-fast | 173 Gems ($0.173) |
| Raspberry | İlk kareden canlanan karakterler | raspberry | 360 Gems ($0.36) |
| Seedance | Seedance, sıkı filtreyle | 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, katı filtreli | wan-3.0 | 245 Gems ($0.245) |
| Wan Video v2.2 | Lightning varyantlı açık ağırlıklı video | wan22-video, wan22-video-lightning | 40 Gems ($0.04) |
Hızlı başlangıç
Berry 2 ile video üret
MAGE_API_KEY'i ayarla, isteği gönder ve tamamlanana kadar sorgula. URL'deki berry yerine yukarıdaki herhangi bir modeli yazabilirsin.
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"])Nasıl çalışır
API anahtarından hazır medyaya üç çağrıda
Tüm modeller aynı kimlik doğrulama şemasını, aynı asenkron istek yaşam döngüsünü ve aynı alan adlarını kullanır.
API anahtarı oluştur
Mage'e giriş yap, API → API Keys bölümünü aç ve bir anahtar oluştur. Anahtar mage_sk_ ile başlar ve yalnızca bir kez gösterilir. Bir hesapta 10 etkin anahtar bulunabilir.
Üretim gönder
Authorization: Bearer başlığıyla https://api.mage.space/v1/{model}/generate adresine JSON gövdeli bir POST gönder. Yanıt hemen bir request_id, bir status ve bir status_url ile döner. Yeniden denemede iki kez ödeme yapmamak için Idempotency-Key başlığı gönder.
Durumu sorgula ve indir
Durum completed, failed veya cancelled olana kadar status_url'yi sorgula. Tamamlanan istek, görsel, video veya ses dosyasını içeren result.url alanını taşır; dosya 30 gün saklanır.
Üretim için tasarlandı
Her Mage API isteğinde neler var?
Tek anahtar, tüm modeller
Tek bir REST API ve tek bir Gems bakiyesiyle 37 görsel, video ve ses modeli. URL yolunu değiştirerek model değiştir.
Üretim başına ödeme
Abonelik ve minimum harcama yok. Gem satın alırsın, her istek listelenen fiyat kadar ücretlendirilir. Başarısız olan üretimin ücreti iade edilir; Mage'in içerik politikasına takılanlar hariç.
Güvenli yeniden deneme
Idempotency anahtarları sayesinde yeniden gönderilen istek, tekrar ücret alınmadan ilk isteği döndürür.
Tutarlı karakterler
Bir karakteri veya referansı bir kez kaydet, sonra desteklenen her modelde kullanmak için herhangi bir prompt'a @handle yaz.
Büyük girdiler
Görsel, video ve ses girdilerini URL veya data URL olarak gönder ya da imzalı yükleme ile 100 MB'a kadar dosya yükle.
Aynı anda 20 üretim
Her hesap aynı anda 20 üretim çalıştırabilir; bu sınır kullanım amacına göre yükseltilebilir. Reddedilen isteklerden asla ücret alınmaz.
Kullanım alanları
Geliştiriciler video API'siyle neler yapıyor?
Kısa ve sosyal medya videoları
Bir prompt'tan veya ürün görselinden TikTok, Reels ve Shorts için dikey klipler üret.
Durağan görselleri canlandır
Lemon ve Kiwi gibi görselden video modelleriyle bir ilk kareyi ya da ilk ve son kareyi harekete dönüştür.
Karakter odaklı hikâyeler
@handle karakterleri kabul eden referanstan video modelleriyle aynı karakteri çekimler boyunca koru.
Sesli video
Plum ve diğer modeller görüntüyle birlikte konuşma, ses efektleri ve ortam sesi üretir; sesler için ses referansları da alır.
Reklamlar ve ürün tanıtımları
Bir reklamın birçok varyantını üret ve kazananı seç; mükerrer gönderimde asla çift ücret almayan idempotent gönderimlerle.
Mevcut klipleri düzenle
Berry, Plum ve Grok Video gönderdiğin kaynak videoyu düzenler; Lemon ve MiniMax-H3 ayrıca referans videoları da alır.
SSS
Sık sorulan sorular
En iyi yapay zeka video üretim API'si hangisi?
Video API'si görselden videoyu destekliyor mu?
Üretilen videolar ne kadar uzun olabilir?
Video üretimi ne kadar sürer?
Mage API ne kadar?
API'yi kullanmak için Mage üyeliği gerekir mi?
API çıktılarını ticari amaçla kullanabilir miyim?
Hız limitleri neler?
Yapay zeka ajanım Mage API'sini kullanabilir mi?
Mage API için bir SDK var mı?
Zaten başka bir üretim API'si kullanıyorum. Neyi değiştirmem gerekiyor?
Mage ile geliştirmeye başla
Tek hesap, tek Gems bakiyesi, tüm modeller. Yalnızca ürettiğin kadar öde.