Mage API · Bir sonraki fikrin için tasarlandı
Tek API. Sınırsız olasılık.
Mage'in en iyilerini ürününe ve yapay zeka asistanına taşı. Tek bir API anahtarı veya tek bir MCP bağlantısıyla görsel, video ve ses üret.
https://api.mage.space/v1Bir bakışta
Mage, geliştiricilere https://api.mage.space/v1 adresinde bir REST API ve https://mcp.mage.space/mcp adresinde uzak bir MCP sunucusu sunar. İkisi de Mage'e özel Mango 4 ve Cherry 2 Pro dahil aynı 37 görsel, video ve ses modelini tek hesapta çalıştırır; her üretim abonelik olmadan Gems ile ödenir.
- 37Model
- 3Medya türü
- 16MCP aracı
- $0Aylık ücret
Başlama yolları
Kodundan, asistanından veya ComfyUI'dan çağır
Mage API
Bir anahtarla kendi kodundan üretim gönder. Asenkron istekler, idempotent yeniden denemeler, 100 MB'a kadar yükleme ve aynı anda 20 üretim.
TypeScript ve Python SDK'ları
Birkaç satırda gönderen, sonucu bekleyen, güvenle yeniden deneyen ve dosya yükleyen resmi, tipli istemciler.
Mage MCP sunucusu
Claude, ChatGPT, Claude Code, Grok veya Cursor'ı oturum açarak bağla; görsel, video ve ses isteklerini sade bir dille yaz.
ComfyUI için Mage
Mango, Cherry, Seed Audio ve diğer tüm Mage modelleri ComfyUI düğümleri olarak. GPU yok, model indirmek yok.
Medya türüne göre
Üretim API'leri
Yapay zeka görsel üretme API'si
Metinden görsele, düzenleme ve 4K'ya kadar tutarlı karakterler.
Yapay zeka video üretme API'si
Metinden videoya, görselden videoya, kareler, referanslar ve ses.
Yapay zeka ses üretme API'si
Bir prompt'tan sesler, anlatım, müzik ve ses efektleri.
Hızlı başlangıç
İlk üretimin
API → API Keys bölümünde bir anahtar oluştur, MAGE_API_KEY olarak dışa aktar ve bunlardan birini çalıştır.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/mango/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "mango-v4"
}' | 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('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"])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.
MCP
Yapay zeka asistanında Mage
Claude'da Mage
Web'de, masaüstü uygulamasında, mobil uygulamalarda ve Cowork'te Claude içinde görsel, video ve ses üret.
ChatGPT'de Mage
ChatGPT içinde kişisel bir MCP uygulaması olarak görsel, video ve ses üret.
Claude Code'da Mage
Terminalinde ve editöründe Claude Code ile görsel, video ve ses üret.
Grok'ta Mage
Grok'ta özel bağlayıcı olarak görsel, video ve ses üret.
Cursor'da Mage
Cursor Agent modunda görsel, video ve ses üret.
Modeller
Öne çıkan modeller
Flux 2 API
Uzun prompt'lar ve çoklu referanslı düzenlemeler
GPT Image 2 API
Hassas prompt'lar ve okunaklı metin
Guava API
Fotoğraf sanılacak kadar gerçekçi görseller
Mango API
Amiral gemisi görsel model ailemiz
Nano Banana 2 API
Net, okunaklı metin, 4K'ya kadar
Cherry API
Amiral gemisi video model ailemiz
Lemon API
Tüm video özellikleri, daha uygun fiyata
Plum API
Her klipte ses, 2K'ya kadar
Seed Audio API
Tek bir prompt'tan sesler, müzik ve ses efektleri
Ü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.
SSS
Sık sorulan sorular
Mage API nedir?
Mage MCP sunucusu nedir?
MCP sunucusunu kullanmak için API anahtarı gerekir mi?
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.