Mage API · Ses üretimi
Ses, müzik ve efektler için yapay zeka ses üretim API'si
Seed Audio ile tek bir komuttan konuşma, seslendirme, müzik ve ses efektleri; ayrıca ses referansları ile konuşma hızı, ses seviyesi ve perde kontrolleri.
POST https://api.mage.space/v1/{model}/generateBir bakışta
Mage ses üretim API'si, Seed Audio'yu https://api.mage.space/v1/seed_audio/generate adresinde çalıştırır. Bir metin komutu gönder, istersen ses referansları veya bir görsel ekle; sesler, müzik ya da ses efektleri içeren, 120 saniyeye kadar uzunlukta bir ses dosyası al. Her klip Gems ile ödenir, abonelik gerekmez.
- 4ses modeli
- $0.019En ucuz varsayılan, klip başına
- 20Eşzamanlı üretim
- $0Aylık ücret
Modeller
Mage API'deki tüm ses 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 |
|---|---|---|---|
| Eleven Music | ElevenLabs şarkıları, vokalli ya da vokalsiz | eleven-music-v2.5 | 113 Gems ($0.113) |
| Eleven Speech | ElevenLabs v4: yönlendirebileceğin gerçekçi konuşma | eleven-v4 | 30 Gems ($0.03) |
| MiniMax Music 3 | Sözlerinden tam şarkılar, açık ağırlıklı | minimax-music-3 | 125 Gems ($0.125) |
| Seed Audio | Tek bir komuttan ses, müzik ve ses efektleri | seed-audio-1.0 | 19 Gems ($0.019) |
Hızlı başlangıç
Eleven Music v2.5 ile ses üret
MAGE_API_KEY değerini ayarla, isteği gönder ve tamamlanana kadar yokla. URL'deki eleven_music yerine yukarıdaki herhangi bir modeli yazabilirsin.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/eleven_music/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.",
"duration": "30",
"model_id": "eleven-music-v2.5"
}' | 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('eleven_music', {
prompt: 'An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.',
duration: '30',
model_id: 'eleven-music-v2.5',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("eleven_music", {
"prompt": "An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.",
"duration": "30",
"model_id": "eleven-music-v2.5",
})
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ştiricilerin ses API'siyle yaptıkları
Anlatım ve seslendirme
Videolar, tanıtım içerikleri ve sesli kitaplar için konuşma hızı, ses seviyesi ve perde kontrolleriyle anlatım üret.
Tutarlı sesler
Bir ses klibini referans olarak kaydet ve @handle ile anarak klipler boyunca aynı sesi koru.
Ses efektleri
Oyunlar ve uygulamalar için bir açıklamadan ortam sesleri, foley ve arayüz sesleri oluştur.
Fon müzikleri
Sosyal medya klipleri ve reklamlar için bir komuttan fon müziği üret.
Üretilen videolar için film müziği
Sessiz modellerin ürettiği kliplere ses eklemek için Seed Audio'yu video API'siyle birlikte kullan.
Konuşan ajanlar
Claude'un, ChatGPT'nin ya da kendi ajanının MCP sunucusu veya REST API üzerinden ses üretmesini sağla.
SSS
Sık sorulan sorular
Ses API'si metinden konuşma üretebilir mi?
Üretilen ses ne kadar uzun olabilir?
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.