Mage API · Video üretimi

Metinden veya görsellerden çalışan yapay zeka video üretim API'si

Mage'in amiral gemisi Cherry 2 Pro başta olmak üzere 12 modelden metinden video, görselden video, ilk-son kareden video ve referanstan video; birçok klipte ses desteğiyle.

API anahtarı alAPI dokümanlarını oku
POST https://api.mage.space/v1/{model}/generate

Bir bakışta

Mage video üretim API'si, https://api.mage.space/v1 adresindeki bir REST API'dir ve Cherry 2 Pro, Lemon, Plum, Melon, MiniMax-H3, Grok Video ve Wan dahil 12 metinden video ve görselden video modelini çalıştırır. Bir prompt ile isteğe bağlı kareleri veya referansları gönder, isteği sorgula ve MP4 indir. Her klip; modele, çözünürlüğe ve süreye göre Gems ile ödenir.

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.

ModelEn uygun kullanımmodel_id değerleriVarsayılan fiyat
BerryReferanslarına sadık kalan videoberry, berry-2189 Gems ($0.189)
Blueberryİlk ve son kareyi sabitleblueberry, blueberry-v2360 Gems ($0.36)
CherryAmiral gemisi video ailemizcherry-mini, cherry, cherry-pro, cherry-2-pro618 Gems ($0.618)
Grok VideoHareket halinde Grok Imaginegrok-imagine-video375 Gems ($0.375)
KiwiGünlük videolar, sıfır kurulumkiwi270 Gems ($0.27)
LemonTüm video özellikleri, daha uygun fiyatalemon245 Gems ($0.245)
LTX VideoDenemeler için hızlı, açık ağırlıklı videoltx-video-096-distilled, ltx-video-096-dev20 Gems ($0.02)
MelonHareket halinde anime, isteğe bağlı seslemelon, melon-pro147 Gems ($0.147)
MiniMax-H3Stereo sesli hızlı açık videominimax-h3-turbo, minimax-h330 Gems ($0.03)
PlumHer klipte ses, 2K'ya kadarplum, plum-max338 Gems ($0.338)
Raspberryİlk kareden canlanan karakterlerraspberry360 Gems ($0.36)
Wan Video v2.2Lightning varyantlı açık ağırlıklı videowan22-video, wan22-video-lightning40 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.

  1. 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.

  2. Ü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.

  3. 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 Gem bakiyesiyle 28 görsel, video ve ses modeli. URL yolunu değiştirerek model değiştirebilirsin.

Ü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?

Mage'de video için varsayılan model Cherry 2 Pro: karakterleri, çok sayıda referans görseli, ses referanslarını, 480p'den 1080p'ye çıktıyı ve 30 saniyeye kadar klipleri destekler. İlk ve son kare kontrolü için Lemon, 2K'ya kadar sesli klipler için Plum, daha ucuz taslaklar için Cherry Mini veya Wan tercih edilir.

Video API'si görselden videoyu destekliyor mu?

Evet. Görselden video modelleri bir ilk kare alır; bazıları ayrıca son kare veya referans görselleri de URL, data URL ya da yükleme olarak kabul eder. Her model sayfasında girdileri ve görselin zorunlu olup olmadığı listelenir.

Üretilen videolar ne kadar uzun olabilir?

Modele ve çözünürlüğe göre değişir. Birçok model 4 ila 15 saniyelik video üretir; Cherry 2 Pro ise 20, 25 ve 30 saniyeye ulaşır. Her model sayfasında süreleri listelenir.

Video üretimi ne kadar sürer?

Modele, çözünürlüğe ve süreye göre değişir. API asenkron çalışır: isteği gönder, ardından status_url'yi geri çekilme (backoff) ile sorgula ya da MCP istemcin get_request ile beklesin.

Mage API ne kadar?

Abonelik veya aylık ücret yoktur. Her üretim, modelin listelenen fiyatı üzerinden Gem ile ödenir; standart pakette 1.000 Gem 1 $ tutarındadır. Her model sayfasında varsayılan ayarların fiyatı yer alır ve her yanıt tam ücreti bildirir. Başarısız olan üretimin ücreti iade edilir; Mage'in içerik politikasına takılanın iade edilmez. Bakiyenin karşılayamadığı istek, hiçbir ücret alınmadan reddedilir.

API'yi kullanmak için Mage üyeliği gerekir mi?

Hayır. API yalnızca Gem ile çalışır. Üyelik planları ve uygulama içi sınırsız üretim API isteklerine uygulanmaz; yani Gem'i olan her Mage hesabı API'yi kullanabilir.

API çıktılarını ticari amaçla kullanabilir miyim?

Evet. Mage ile oluşturduğun içerikler, API ve MCP sunucusu üzerinden oluşturdukların da dahil, ticari olarak kullanılabilir. Atıf yapmanı memnuniyetle karşılarız ama zorunlu değil.

Hız limitleri neler?

Bir hesapta aynı anda 20 üretim sırada bekleyebilir veya çalışabilir. Bunun üzerindeki bir gönderim 429 hatasıyla reddedilir ve hiçbir ücret alınmaz. Kullanım senaryon için limiti artırmak istersen [email protected] adresine yaz.

Yapay zeka ajanım Mage API'sini kullanabilir mi?

Evet. Ajanlar REST API'yi bir anahtarla çağırabilir ya da Mage MCP sunucusuna bağlanabilir. Bu sunucu Claude, ChatGPT, Claude Code, Grok ve Cursor'a model seçmek, fiyat teklifi almak, üretim yapmak ve sonucu getirmek için hazır on altı araç sunar. Bkz. MCP sunucusu.

Mage API için bir SDK var mı?

Evet. npm'deki resmi @mage-space/sdk paketi ve PyPI'daki mage-space açık kaynaklıdır ve her model için tiplendirilmiştir. İstekleri gönderir, sonucu bekler, güvenli şekilde yeniden dener ve dosyaları senin yerine yükler. ComfyUI kullanıcıları comfyui-mage node paketini kurabilir. Bkz. Mage SDK'ları.

Zaten başka bir üretim API'si kullanıyorum. Neyi değiştirmem gerekiyor?

İstemcini https://api.mage.space/v1 adresine yönlendir, Mage anahtarını Bearer token olarak gönder ve alanlarını model sayfasıyla eşleştir: prompt, aspect_ratio, resolution, duration ve model_id her Mage modelinde aynı şekilde çalışır. İstekler asenkron olduğu için önce gönder, sonra status_url'i düzenli olarak sorgula.

Mage ile geliştirmeye başla

Tek hesap, tek Gems bakiyesi, tüm modeller. Yalnızca ürettiğin kadar öde.

API anahtarı alAPI dokümanlarını oku

İlgili