Mage API · SDK'lar
Mage API için resmi SDK'lar
TypeScript ve Python için tip tanımlı istemciler, ComfyUI için Mage node'ları. Tüm görsel, video ve ses modelleri birkaç satır kodda.
Bir bakışta
Mage, API'si için açık kaynak 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. Her biri REST API'yi 37 modelin tamamı için tipli yapılandırmalar, otomatik yoklama, idempotent yeniden denemeler ve yüklemelerle sarmalar.
- 3SDK ve entegrasyonlar
- 37Tip tanımlı modeller
- MITAçık kaynak
- $0Kurulum için
Sana uygun olanı seç
SDK ve entegrasyonlar
npm install @mage-space/sdkTypeScript 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-spacePython 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-mageComfyUI 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-v4',
});
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-v4",
})
print(request["result"]["url"])Hazır gelir
Her SDK senin için neleri halleder?
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.
İ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ı?
Yeni Mage modelleri eski bir SDK ile çalışır mı?
SDK'lar yeniden denenen bir istek için iki kez ödeme yapılmasını nasıl önler?
SDK'lar kararlı mı?
Mage API ne kadar?
API'yi kullanmak için Mage üyeliği gerekir mi?
API çıktılarını ticari amaçla kullanabilir miyim?
Mage ile geliştirmeye başla
Tek hesap, tek Gems bakiyesi, tüm modeller. Yalnızca ürettiğin kadar öde.