رفتن به محتوا

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: از روی یک توضیح، آهنگ با متن و وکال یا قطعه بی‌کلام بسازید، دقیقاً به اندازه‌ای که انتخاب می‌کنید، تا ۵ دقیقه.

مدل موسیقی 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

  • پرامپت آهنگ را توصیف می‌کند و حداکثر 2000 نویسه است.

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

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

  • صدا · از ۳۰ Gem

    Eleven Speech API

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

  • صدا · از ۱۹ Gem

    Seed Audio API

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

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

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

هزینه Eleven Music API چقدر است؟
یک درخواست Eleven Music با تنظیمات پیش‌فرض (Eleven Music v2.5) 113 Gems، حدود 0.113 دلار هزینه دارد. رزولوشن، مدت‌زمان و نسخه‌های دیگر قیمت را تغییر می‌دهند؛ پاسخ، هزینه دقیق را اعلام می‌کند. تولیدی که ناموفق شود بازپرداخت می‌شود، اما تولیدی که سیاست محتوایی Mage جلوی آن را بگیرد بازپرداخت نمی‌شود.
نقطه پایانی Eleven Music API چیست؟
POST https://api.mage.space/v1/eleven_music/generate همراه با هدر Authorization: Bearer که کلید API شما در Mage را دارد. پاسخ شامل یک status_url است تا نتیجه را با آن بررسی کنید.
کدام مدل‌های Eleven Music را می‌توانم فراخوانی کنم؟
eleven-music-v2.5 (Eleven Music v2.5). مدل پیش‌فرض Eleven Music v2.5 است.
آیا Eleven Music از تصویر مرجع یا شخصیت پشتیبانی می‌کند؟
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، همهٔ مدل‌ها. فقط برای چیزی که تولید می‌کنی هزینه بپرداز.