Tüm modeller için yapay zeka görsel oluşturma API'si

Bir bakışta

Mage görsel oluşturma API'si, https://api.mage.space/v1 adresinde çalışan ve Mango 3, Guava 2 Pro, GPT Image 2.5, Nano Banana 2, Flux 2 ve Krea 2 dahil 15 metinden görsele ve görsel düzenleme modelini çalıştıran bir REST API'dir. /{model}/generate adresine bir prompt gönderir (POST), isteği sorgular ve görseli indirirsin. Her görselin ücreti Gems ile ödenir, abonelik gerekmez.

• 15

  görsel modeli

• $0.009

  Görsel başına en ucuz varsayılan

• 20

  Eşzamanlı üretim

• $0

  Aylı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.

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.

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"

// 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);

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

1. 01

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

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

   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?

Kullanım alanları

Geliştiriciler görsel API'siyle neler yapıyor

SSS

Sık sorulan sorular

Mage ile geliştirmeye başla

Tek hesap, tek Gems bakiyesi, tüm modeller. Yalnızca ürettiğin kadar öde.

İlgili

• Yapay zeka video oluşturma API'si
• Yapay zeka ses oluşturma API'si
• Mage MCP sunucusu
• Mage SDK'ları
• ComfyUI için Mage
• Tüm API modelleri
• API test alanı
• API dokümantasyonu