Mage API · نموذج صوتي
واجهة Eleven Music API
أغانٍ من ElevenLabs، بأصوات غنائية أو بدونها
POST https://api.mage.space/v1/eleven_music/generateلمحة سريعة
تشغّل واجهة Eleven Music API النموذج Eleven Music v2.5 عبر Mage على POST https://api.mage.space/v1/eleven_music/generate. يكلّف الطلب بالإعدادات الافتراضية 113 Gems (نحو $0.113)، دون اشتراك. لا يقبل Eleven Music إشارات @handle.
- صوتالمخرجات
- 1النسخة
- 113Gems لكل مقطع، افتراضيًا
- $0.113التكلفة التقريبية بالدولار
نظرة عامة
ما الذي تقدّمه واجهة Eleven Music API
Eleven Music من ElevenLabs: أغانٍ بكلمات وأصوات غنائية، أو مقطوعات موسيقية بدون غناء، انطلاقًا من وصف نصي، وبالمدة التي تختارها بالضبط حتى 5 دقائق.
نموذج الموسيقى من ElevenLabs: أغانٍ بأصوات غنائية أو مقطوعات موسيقية فقط، بصيغة MP3 وبالمدة المطلوبة تمامًا. ترفض ElevenLabs أي وصف يذكر اسم فنان أو يقتبس كلمات أغانٍ محمية بحقوق النشر؛ يفشل الطلب ويُسترد المبلغ.
يُنشئ الصورة من الوصف النصي فقط.
بداية سريعة
استدعاء واجهة Eleven Music API
عيّن MAGE_API_KEY، وأرسل الطلب إلى /eleven_music/generate، ثم استعلم عن status_url دوريًا حتى يكتمل الطلب.
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"])النماذج
قيم model_id في Eleven Music
أرسل model_id لاختيار إصدار. الطلب الذي لا يتضمنه يستخدم الإصدار الافتراضي.
| model_id | الاسم | افتراضي |
|---|---|---|
| eleven-music-v2.5 | Eleven Music v2.5 | نعم |
الخيارات
معلمات Eleven Music
القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.
| الحقل | القيم |
|---|---|
| duration | 10, 30, 60, 120, 180, 300 |
القواعد
ما الذي تفرضه واجهة Eleven Music API
- يصف الـ prompt الأغنية، بحد أقصى 2000 حرف.
المزيد من النماذج الصوتية
واجهات توليد الصوت الأخرى على Mage
واجهة Eleven Speech API
ElevenLabs v4: كلام واقعي يمكنك توجيهه
واجهة Seed Audio API
أصوات وموسيقى ومؤثرات صوتية من أمر واحد
الأسئلة الشائعة
الأسئلة الشائعة
كم تكلفة واجهة Eleven Music API؟
ما نقطة النهاية (endpoint) لواجهة Eleven Music API؟
ما نماذج Eleven Music التي يمكنني استدعاؤها؟
هل يدعم Eleven Music الصور المرجعية أو الشخصيات؟
هل يمكنني استخدام Eleven Music من Claude أو ChatGPT؟
كم المدة التي تُحفظ فيها نتائج Eleven Music؟
ابدأ البناء مع Mage
حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.