İçeriğe geç

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/v1

Bir 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

  • REST API

    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.

  • SDK'lar

    TypeScript ve Python SDK'ları

    Birkaç satırda gönderen, sonucu bekleyen, güvenle yeniden deneyen ve dosya yükleyen resmi, tipli istemciler.

  • MCP sunucusu

    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

    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

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.

  1. 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.

  2. Ü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.

  3. 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

  • Görsel · 40 Gem'den başlayan fiyatlarla

    Flux 2 API

    Uzun prompt'lar ve çoklu referanslı düzenlemeler

  • Görsel · 9 Gem'den başlayan fiyatlarla

    GPT Image 2 API

    Hassas prompt'lar ve okunaklı metin

  • Görsel · 37 Gem'den başlayan fiyatlarla

    Guava API

    Fotoğraf sanılacak kadar gerçekçi görseller

  • Görsel · 42 Gem'den başlayan fiyatlarla

    Mango API

    Amiral gemisi görsel model ailemiz

  • Görsel · 51 Gems'ten başlayan fiyatlarla

    Nano Banana 2 API

    Net, okunaklı metin, 4K'ya kadar

  • Video · 618 Gem'den başlayan fiyatlarla

    Cherry API

    Amiral gemisi video model ailemiz

  • Video · 245 Gem'den başlayan fiyatlarla

    Lemon API

    Tüm video özellikleri, daha uygun fiyata

  • Video · 173 Gems'ten başlayan fiyatlarla

    Plum API

    Her klipte ses, 2K'ya kadar

  • Ses · 19 Gem'den başlayan fiyatlarla

    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 API, kendi kodundan 37 modelle görsel, video ve ses üretmek için https://api.mage.space/v1 adresindeki bir REST API'dir. İstekler asenkrondur ve üretim başına Gems ile ödenir.
Mage MCP sunucusu nedir?
https://mcp.mage.space/mcp adresinde çalışan, yapay zeka asistanlarının Mage hesabında görsel, video ve ses üretmesini sağlayan uzak bir Model Context Protocol sunucusudur. Asistana model seçme, fiyat sorma, üretme, sonucu bekleme ve kayıtlı karakterlerini, referanslarını ve geçmişini kullanma için 16 araç sunar.
MCP sunucusunu kullanmak için API anahtarı gerekir mi?
Hayır. Claude, ChatGPT, Grok, Cursor ve Claude Code, OAuth ile Mage'e giriş yapılarak bağlanır. API anahtarı isteğe bağlıdır ve CI gibi arayüzsüz kurulumlar için kullanılı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 bunların sunduğu uygulama içi sınırsız üretim API isteklerinde geçerli değildir. Hesabın önce bir kez başarılı ödeme yapması gerekir (herhangi bir Gem paketi veya plan olabilir). Kayıt bonusu olarak verilen Gem'ler yalnızca Mage uygulamasında kullanılabilir.
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.

CharactersTopluluk