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-v4 | Eleven v4 | نعم |
الخيارات
معلمات Eleven Speech
القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.
| الحقل | القيم |
|---|---|
| voice | darian, 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
واجهة Seed Audio API
أصوات وموسيقى ومؤثرات صوتية من أمر واحد
Eleven Music API
أغانٍ من ElevenLabs، بأصوات غنائية أو بدونها
الأسئلة الشائعة
الأسئلة الشائعة
كم تبلغ تكلفة Eleven Speech API؟
ما هي نقطة نهاية Eleven Speech API؟
أي نماذج Eleven Speech يمكنني استدعاؤها؟
هل يدعم Eleven Speech الصور المرجعية أو الشخصيات؟
هل يمكنني استخدام Eleven Speech من Claude أو ChatGPT؟
ما مدة الاحتفاظ بنتائج Eleven Speech؟
ابدأ البناء مع Mage
حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.