Tek çağrı, hazır medya
run üretimi gönderir, API'nin önerdiği geri çekilme süreleriyle durumu yoklar ve result.url içeren tamamlanmış isteği döndürür.
Bir bakışta
Mage, API'si için açık kaynaklı SDK'lar yayınlar: TypeScript ve JavaScript için npm'de @mage-space/sdk, Python için PyPI'da mage-space ve ComfyUI için comfyui-mage node paketi. Hepsi REST API'yi sarmalar; 28 modelin tamamı için tip tanımlı yapılandırmalar, otomatik yoklama, idempotent yeniden denemeler ve yüklemeler sunar.
3
SDK ve entegrasyonlar
28
Tip tanımlı modeller
MIT
Açık kaynak
$0
Kurulum için
Sana uygun olanı seç
SDK ve entegrasyonlar
npm install @mage-space/sdk
TypeScript SDK'sı
Her Mage modeli için tip tanımlı yapılandırmalarla Node.js'ten görsel, video ve ses üret. Tek çağrı isteği gönderir, bekler ve sonucu döndürür.
pip install mage-space
Python SDK'sı
Senkron ve asyncio istemcileri ile her Mage modeli için tip tanımlı yapılandırmalarla Python'dan görsel, video ve ses üret.
comfy node install comfyui-mage
ComfyUI için Mage
Mango, Cherry, Seed Audio ve diğer tüm Mage modelleri ComfyUI düğümleri olarak. GPU yok, model indirmek yok.
Hızlı başlangıç
Bir SDK ile ilk üretimin
Paketi kur, MAGE_API_KEY değişkenini ayarla ve bir model çalıştır.
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('mango', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'mango-v3',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("mango", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "mango-v3",
})
print(request["result"]["url"])Hazır gelir
Her SDK senin için neleri halleder?
İki kez ödetmeyen yeniden denemeler
Her istek bir idempotency anahtarı taşır. Ağ ve sunucu hataları geri çekilmeyle yeniden denenir, yeniden denenen istek için tekrar ücret alınmaz.
Tek çağrıda yükleme
Data URL için fazla büyük dosyalar imzalı yükleme üzerinden gider; bilet, PUT isteği ve boyut kontrolü senin yerine halledilir.
Anlaşılır hatalar
API ret yanıtları HTTP durumunu, hata kodunu ve istek kimliğini taşır; başarısız veya iptal edilen üretimlerin ve zaman aşımlarının kendi hata türleri vardır.
Paketler
Nereden edinirsin?
| SDK | Paket | Kurulum | Kaynak |
|---|---|---|---|
| TypeScript SDK'sı | @mage-space/sdk | npm install @mage-space/sdk | GitHub |
| Python SDK'sı | mage-space | pip install mage-space | GitHub |
| ComfyUI için Mage | comfyui-mage | comfy node install comfyui-mage | GitHub |
SSS
Sık sorulan sorular
Mage SDK'ları ücretsiz ve açık kaynak mı?
Evet. SDK'lar ve ComfyUI düğümleri GitHub'da MIT lisanslıdır ve kurulumları ücretsizdir. Yalnızca çalıştırdığın üretimler için, her modelin belirtilen fiyatı üzerinden Gems ile ödersin.
Yeni Mage modelleri eski bir SDK ile çalışır mı?
Evet. Yeni modelin kimliğini bir metin olarak ver, çalışır; SDK yapılandırmayı her modelin ortak kullandığı alanlara göre kontrol eder. API referansı değiştiğinde bir bot tipleri günceller, böylece yeni modeller kendi tipleriyle bir sonraki sürümde gelir.
SDK'lar yeniden denenen bir istek için iki kez ödeme yapılmasını nasıl önler?
Her gönderim bir Idempotency-Key taşır. SDK her çağrı için yeni bir anahtar oluşturur ve o çağrıyı kendisi yeniden denediğinde aynı anahtarı kullanır. Böylece yeniden denenen gönderim orijinal isteği döndürür ve ek ücret almaz.
SDK'lar kararlı mı?
0.x sürümünde beta aşamasındalar, bu yüzden bir alt sürüm onları değiştirebilir. API'nin kendisi ayrı sürümlenir ve v1 içinde kararlı kalır.
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.
Mage ile geliştirmeye başla
Tek hesap, tek Gems bakiyesi, tüm modeller. Yalnızca ürettiğin kadar öde.