Mage API · Görsel oluşturma
Tüm modeller için yapay zeka görsel oluşturma API'si
Mage'in amiral gemisi Mango 4 dahil 18 modelden metinden görsele, görsel düzenleme ve tutarlı karakterler; tek anahtar ve tek bakiye ile.
POST https://api.mage.space/v1/{model}/generateBir bakışta
Mage görsel üretim API'si, Mango 4, Guava 2 Pro, GPT Image 2.6, Nano Banana 2, Flux 2 ve Krea 2 dahil 18 metinden görsele ve görsel düzenleme modelini çalıştıran, https://api.mage.space/v1 adresindeki bir REST API'dir. /{model}/generate yoluna prompt'u POST edersin, isteği yoklarsın ve görseli indirirsin. Her görsel Gems ile ödenir, abonelik yoktur.
- 18görsel modeli
- $0.009Görsel başına en ucuz varsayılan
- 20Eşzamanlı üretim
- $0Aylık ücret
Modeller
Mage API'sindeki tüm görsel 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, gpt-image-2.6-flare, gpt-image-2.6-sunburst | 9 Gems ($0.009) |
| Grok Image | Grok Imagine, iki seviyede | grok-imagine-image, grok-imagine-image-2.0 | 90 Gems ($0.09) |
| 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, mango-v4 | 42 Gems ($0.042) |
| MiniMax H3 Image | Yerel 16 megapiksel görseller, açık ağırlıklar | minimax-h3-image | 15 Gems ($0.015) |
| MOSS-Image | Uzun prompt'lar ve iki dilli metin, açık ağırlıklar | moss-image | 25 Gems ($0.025) |
| Nano Banana 2 | Net, okunaklı metin, 4K'ya kadar | nano-banana-v2, nano-banana-v2.1 | 51 Gems ($0.051) |
| SDXL Plus | Yüzleri ve elleri düzeltilmiş SDXL | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| Seedream | Seedream, sıkı filtreyle | seedream-4.0, seedream-4.5, seedream-5.0-lite, seedream-5.0-pro, seedream-5.0-flash, seedream-5.5 | 42 Gems ($0.042) |
| 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) |
Hızlı başlangıç
Anima v1 ile görsel oluştur
MAGE_API_KEY'i ayarla, isteği gönder ve tamamlanana kadar sorgula. URL'deki anima yerine yukarıdaki modellerden herhangi birini yazabilirsin.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/anima/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": "anima-v1"
}' | 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('anima', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'anima-v1',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("anima", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "anima-v1",
})
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.
Ü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.
Kullanım alanları
Geliştiriciler görsel API'siyle neler yapıyor
Ürün ve pazarlama görselleri
Ürün fotoğraflarını, reklam varyasyonlarını ve sosyal medya gönderilerini istediğin an oluştur; GPT Image 2.6 veya Nano Banana 2 ile okunaklı yazılar elde et.
Tutarlı karakterler
Bir karakteri bir kez kaydet; Mango 4, Guava 2 Pro ve @handle bahsetmelerini destekleyen diğer modellerle tüm set boyunca aynı yüzü koru.
Görsel düzenleme akışları
Kaynak görseli bir talimatla gönder; yalnızca istediğin yer değişsin, geri kalan olduğu gibi kalsın.
Uygulamalar ve oyunlar
Tek bir GPU barındırmadan ürününün içinde avatarlar, çıkartmalar, kartlar ve sahneler üret.
Fotogerçekçi portreler
Guava 2 Pro; portre, moda ve yaşam tarzı karelerini gerçeğe sadık cilt, kumaş ve ışıkla oluşturur.
Büyük ölçekte hızlı taslaklar
Z-Image Turbo ve Krea 2, yüksek hacimli kapak görselleri ve ilk denemeler için fiyatları düşük tutar.
SSS
Sık sorulan sorular
En iyi yapay zeka görsel üretim API'si hangisi?
Görsel API'si görsel düzenlemeyi ve referans görselleri destekliyor mu?
Görsel API'si hangi çözünürlükleri destekliyor?
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.