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.5 | Eleven Music v2.5 | بله |
گزینهها
پارامترهای Eleven Music
مقادیر مجاز برای همه نسخهها؛ ممکن است یک نسخه گزینههای کمتری داشته باشد. گزینههای هر نسخه در مستندات آمده است.
| فیلد | مقادیر |
|---|---|
| duration | 10, 30, 60, 120, 180, 300 |
قوانین
محدودیتهای Eleven Music API
- پرامپت آهنگ را توصیف میکند و حداکثر 2000 نویسه است.
مدلهای صوتی بیشتر
سایر APIهای تولید صدا در Mage
Eleven Speech API
ElevenLabs v4: گفتار طبیعی و قابل کارگردانی
Seed Audio API
صدا، موسیقی و افکتهای صوتی از یک پرامپت
سؤالات متداول
سؤالات متداول
هزینه Eleven Music API چقدر است؟
نقطه پایانی Eleven Music API چیست؟
کدام مدلهای Eleven Music را میتوانم فراخوانی کنم؟
آیا Eleven Music از تصویر مرجع یا شخصیت پشتیبانی میکند؟
آیا میتوانم از Eleven Music در Claude یا ChatGPT استفاده کنم؟
نتایج Eleven Music تا چه مدت نگهداری میشوند؟
ساختن با Mage را شروع کن
یک حساب، یک موجودی Gems، همهٔ مدلها. فقط برای چیزی که تولید میکنی هزینه بپرداز.