انتقل إلى المحتوى

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.5Eleven Music v2.5نعم

الخيارات

معلمات Eleven Music

القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.

الحقلالقيم
duration10, 30, 60, 120, 180, 300

القواعد

ما الذي تفرضه واجهة Eleven Music API

  • يصف الـ prompt الأغنية، بحد أقصى 2000 حرف.

المزيد من النماذج الصوتية

واجهات توليد الصوت الأخرى على Mage

الأسئلة الشائعة

الأسئلة الشائعة

كم تكلفة واجهة Eleven Music API؟
يكلّف طلب Eleven Music بالإعدادات الافتراضية (Eleven Music v2.5) ‏113 Gems، نحو ‎$0.113. تؤثر الدقة والمدة والإصدارات الأخرى في السعر؛ وتذكر الاستجابة الرسوم الدقيقة. يُسترد المبلغ عند فشل عملية التوليد، ولا يُسترد إذا حجبتها سياسة المحتوى في Mage.
ما نقطة النهاية (endpoint) لواجهة Eleven Music API؟
أرسل POST إلى https://api.mage.space/v1/eleven_music/generate مع ترويسة Authorization: Bearer تحمل مفتاح Mage API الخاص بك. تتضمن الاستجابة status_url للاستعلام عن النتيجة.
ما نماذج Eleven Music التي يمكنني استدعاؤها؟
eleven-music-v2.5 (‏Eleven Music v2.5). النموذج الافتراضي هو Eleven Music v2.5.
هل يدعم Eleven Music الصور المرجعية أو الشخصيات؟
لا يقبل Eleven Music مدخلات من صور أو فيديو أو صوت. ولا يقبل إشارات @handle.
هل يمكنني استخدام Eleven Music من Claude أو ChatGPT؟
نعم. اربط خادم Mage MCP بـ Claude أو ChatGPT أو Claude Code أو Grok أو Cursor واطلب Eleven Music بالاسم. يقرأ مساعدك خياراته عبر get_model ويذكر السعر قبل أن يبدأ التوليد.
كم المدة التي تُحفظ فيها نتائج Eleven Music؟
يُحتفظ بالنتائج والمدخلات لمدة 30 يومًا. نزّل كل ما تريد الاحتفاظ به إلى مساحة التخزين الخاصة بك.

ابدأ البناء مع Mage

حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.