Bir bakışta
Mage API, https://api.mage.space/v1/{model}/generate adresinde 15 görsel modeli, 12 video modeli ve 1 ses modeli çalıştırır. Her model aynı anahtarı, istek akışını ve alan adlarını kullanır; üretim başına Gems ile ödenir.
15
Görsel modelleri
12
Video modelleri
1
Ses modelleri
1
Hepsi için tek API anahtarı
Görsel modelleri
Görsel üretim 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 |
|---|---|---|---|
| Anima | Anime için özel olarak geliştirildi | anima-v1 | 20 Gems ($0.02) |
| Chroma | Açık ağırlıklı, Flux tabanlı | chroma-v1-hd | 35 Gems ($0.035) |
| Flux 2 | Uzun prompt'lar ve çoklu referanslı düzenlemeler | flux2-dev | 40 Gems ($0.04) |
| GPT Image 2 | Hassas prompt'lar ve okunaklı metin | gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst | 9 Gems ($0.009) |
| Grok Image | Grok Imagine, üç kalite seviyesinde | grok-imagine-image, grok-imagine-image-quality, grok-imagine-image-2.0 | 75 Gems ($0.075) |
| Guava | Fotoğraf sanılacak kadar gerçekçi | guava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro | 37 Gems ($0.037) |
| HiDream | Hızlı ve çok yönlü, negatif prompt desteğiyle | hidream-fast | 20 Gems ($0.02) |
| Krea 2 | Saniyeler içinde muhteşem estetik | krea-2-turbo | 20 Gems ($0.02) |
| Mango | Amiral gemisi görsel ailemiz | mango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo | 135 Gems ($0.135) |
| Nano Banana 2 | Net, okunaklı metin, 4K'ya kadar | nano-banana-v2 | 68 Gems ($0.068) |
| SDXL Plus | Yüzleri ve elleri düzeltilmiş SDXL | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| Stable Diffusion v1.5 | Bütçe dostu klasik | 15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D | 10 Gems ($0.01) |
| Stable Diffusion v3.5 Large | En iyi dinleyen Stable Diffusion | sd-3-5-large | 10 Gems ($0.01) |
| Stable Diffusion XL | Fotogerçekçilik için ayarlanmış SDXL | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 10 Gems ($0.01) |
| Z-Image | Mage'deki en hızlı görsel modeli | z-image-turbo | 10 Gems ($0.01) |
Video modelleri
Video üretim modelleri
| 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-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) |
| 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, minimax-h3 | 30 Gems ($0.03) |
| Plum | Her klipte ses, 2K'ya kadar | plum, plum-max | 338 Gems ($0.338) |
| Raspberry | İlk kareden canlanan karakterler | raspberry | 360 Gems ($0.36) |
| Wan Video v2.2 | Lightning varyantlı açık ağırlıklı video | wan22-video, wan22-video-lightning | 40 Gems ($0.04) |
Ses modelleri
Ses üretim modelleri
| Model | En uygun kullanım | model_id değerleri | Varsayılan fiyat |
|---|---|---|---|
| Seed Audio | Tek bir komuttan ses, müzik ve ses efektleri | seed-audio-1.0 | 19 Gems ($0.019) |
SSS
Sık sorulan sorular
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.