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

Mage API · نموذج صوتي

واجهة Eleven Speech API

ElevenLabs v4: كلام واقعي يمكنك توجيهه

POST https://api.mage.space/v1/eleven_speech/generate

لمحة سريعة

تشغّل واجهة Eleven Speech API نموذج Eleven v4 عبر Mage على POST https://api.mage.space/v1/eleven_speech/generate. يكلّف الطلب بالإعدادات الافتراضية 30 Gems (نحو 0.03 دولار)، بدون اشتراك. لا يدعم Eleven Speech إشارات @handle.

  • صوتالمخرجات
  • 1النسخة
  • 30Gems لكل مقطع، افتراضيًا
  • $0.03التكلفة التقريبية بالدولار

نظرة عامة

ما الذي تقدّمه واجهة Eleven Speech API

تحويل النص إلى كلام مع ElevenLabs v4 بـ 16 صوتًا وأكثر من 90 لغة، مع توجيه كل سطر عبر وسوم صوتية مثل [whispers] أو [laughs].

تحويل النص إلى كلام معبّر من ElevenLabs بأكثر من 90 لغة، بصيغة MP3 بطول النص نفسه. توجّه الوسوم الصوتية بين أقواس مربعة طريقة الإلقاء وتضيف مؤثرات صوتية: [whispers] و[laughs] و[sarcastic] و[door slams].

يُنشئ الصورة من الوصف النصي فقط.

بداية سريعة

استدعاء واجهة Eleven Speech API

عيّن MAGE_API_KEY، وأرسل الطلب إلى /eleven_speech/generate، ثم استعلم عن status_url دوريًا حتى يكتمل الطلب.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/eleven_speech/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Every lighthouse keeps one promise... to stay lit until morning. [softly] And this one never broke it.",
  "model_id": "eleven-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('eleven_speech', {
  prompt: 'Every lighthouse keeps one promise... to stay lit until morning. [softly] And this one never broke it.',
  model_id: 'eleven-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("eleven_speech", {
    "prompt": "Every lighthouse keeps one promise... to stay lit until morning. [softly] And this one never broke it.",
    "model_id": "eleven-v4",
})

print(request["result"]["url"])

النماذج

قيم model_id في Eleven Speech

أرسل model_id لاختيار إصدار. الطلب الذي لا يتضمنه يستخدم الإصدار الافتراضي.

model_idالاسمافتراضي
eleven-v4Eleven v4نعم

الخيارات

معلمات Eleven Speech

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

الحقلالقيم
voicedarian, talia, elara, baxter, eldrin, elowen, kaelen, lawrence, alicia, maisie, warren, jade, caleb, sawyer, florence, wyatt

القواعد

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

  • الـ prompt هو النص المراد نطقه، بحد أقصى 5000 حرف، بما في ذلك الوسوم الصوتية.
  • `voice` هو أحد هذه الأصوات: darian, talia, elara, baxter, eldrin, elowen, kaelen, lawrence, alicia, maisie, warren, jade, caleb, sawyer, florence, wyatt.
  • تتراوح قيمة `stability` من 0 (معبّر) إلى 1 (ثابت).

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

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

  • صوت · من 19 Gems

    واجهة Seed Audio API

    أصوات وموسيقى ومؤثرات صوتية من أمر واحد

  • صوت · من 113 Gems

    Eleven Music API

    أغانٍ من ElevenLabs، بأصوات غنائية أو بدونها

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

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

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

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

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