رفتن به محتوا

Mage API · مدل صوتی

Eleven Speech API

ElevenLabs v4: گفتار طبیعی و قابل کارگردانی

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

در یک نگاه

API گفتار Eleven مدل Eleven v4 را از طریق Mage روی POST https://api.mage.space/v1/eleven_speech/generate اجرا می‌کند. هزینه یک درخواست با تنظیمات پیش‌فرض ۳۰ Gem (حدود ۰٫۰۳ دلار) است و اشتراکی لازم نیست. Eleven Speech از منشن @handle پشتیبانی نمی‌کند.

  • صداخروجی
  • 1نسخه
  • 30Gems برای هر کلیپ، پیش‌فرض
  • $0.03حدود، به دلار

نگاه کلی

Eleven Speech API چه کاری انجام می‌دهد

تبدیل متن به گفتار ElevenLabs v4 با ۱۶ صدا و بیش از ۹۰ زبان، با کارگردانی خط‌به‌خط از طریق تگ‌های صوتی مثل [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

  • پرامپت همان متنی است که خوانده می‌شود، حداکثر 5000 نویسه، با احتساب تگ‌های صوتی.
  • `voice` یکی از این موارد است: darian، talia، elara، baxter، eldrin، elowen، kaelen، lawrence، alicia، maisie، warren، jade، caleb، sawyer، florence، wyatt.
  • مقدار `stability` از ۰ (پرحس‌وحال) تا ۱ (یکنواخت و پایدار) است.

مدل‌های صوتی بیشتر

سایر APIهای تولید صدا در Mage

  • صدا · از ۱۹ Gem

    Seed Audio API

    صدا، موسیقی و افکت‌های صوتی از یک پرامپت

  • صدا · از ۱۱۳ Gem

    API ‏Eleven Music

    آهنگ‌های ElevenLabs، با وکال یا بدون آن

سؤالات متداول

سؤالات متداول

هزینه API ‏Eleven Speech چقدر است؟
هزینه یک درخواست Eleven Speech با تنظیمات پیش‌فرض (Eleven v4) ۳۰ Gem، یعنی حدود ۰٫۰۳ دلار است. رزولوشن، مدت‌زمان و نسخه‌های دیگر قیمت را تغییر می‌دهند و هزینه دقیق در پاسخ اعلام می‌شود. اگر تولید ناموفق باشد، هزینه آن برگردانده می‌شود؛ اما اگر سیاست محتوایی Mage جلوی آن را بگیرد، برگردانده نمی‌شود.
نشانی endpoint مربوط به API ‏Eleven Speech چیست؟
درخواست POST به https://api.mage.space/v1/eleven_speech/generate بفرستید و هدر Authorization: Bearer را همراه کلید API ‏Mage خود قرار دهید. پاسخ شامل status_url است که برای دریافت نتیجه باید آن را بررسی کنید.
کدام مدل‌های Eleven Speech را می‌توانم فراخوانی کنم؟
eleven-v4 ‏(Eleven v4). مدل پیش‌فرض Eleven v4 است.
آیا Eleven Speech از تصویر مرجع یا کاراکتر پشتیبانی می‌کند؟
Eleven Speech ورودی تصویر، ویدیو یا صدا نمی‌گیرد. Eleven Speech منشن @handle هم نمی‌پذیرد.
می‌توانم Eleven Speech را از داخل Claude یا ChatGPT استفاده کنم؟
بله. سرور MCP ‏Mage را به Claude، ChatGPT، Claude Code، Grok یا Cursor وصل کنید و Eleven Speech را با نام بخواهید. دستیار شما گزینه‌های آن را با get_model می‌خواند و پیش از تولید، قیمت را اعلام می‌کند.
نتایج Eleven Speech چه مدت نگهداری می‌شوند؟
نتایج و ورودی‌ها 30 روز نگهداری می‌شوند. هر چیزی را که می‌خواهید نگه دارید، در فضای ذخیره‌سازی خودتان دانلود کنید.

ساختن با Mage را شروع کن

یک حساب، یک موجودی Gems، همهٔ مدل‌ها. فقط برای چیزی که تولید می‌کنی هزینه بپرداز.