رفتن به محتوا

Mage API · مدل صوتی

API مدل MiniMax Music 3

آهنگ کامل از روی متن ترانه، با وزن‌های باز

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

در یک نگاه

API مدل MiniMax Music 3 این مدل را از طریق Mage در POST https://api.mage.space/v1/minimax_music/generate اجرا می‌کند. یک درخواست با تنظیمات پیش‌فرض 125 Gems (حدود 0.125 دلار) هزینه دارد و اشتراکی لازم نیست. MiniMax Music 3 از اشاره‌ی @handle پشتیبانی نمی‌کند.

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

نگاه کلی

API مدل MiniMax Music 3 چه کاری انجام می‌دهد

مدل آهنگ‌سازی باز MiniMax: آهنگ کامل تا 5 دقیقه با وکالی که ترانه‌ی شما را می‌خواند، یا قطعه‌ی بی‌کلام، شکل‌گرفته با توصیف سبک، صدا و تنظیم. همراه با LoRA.

مدل آهنگ‌سازی با وزن‌های باز MiniMax: آهنگ کامل با وکال خوانده‌شده بر اساس ترانه، یا قطعه‌ی بی‌کلام، تا 5 دقیقه، به‌صورت MP3 استریو 44.1 kHz، همراه با LoRA. کلمات را در `lyrics` و صدا را در پرامپت بنویسید.

فقط از روی پرامپت تصویر می‌سازد.

شروع سریع

فراخوانی API مدل MiniMax Music 3

MAGE_API_KEY را تنظیم کنید، درخواست را به /minimax_music/generate بفرستید و status_url را تا تکمیل درخواست بررسی کنید.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/minimax_music/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Acoustic pop, 96 BPM, C major, warm and intimate, building into the chorus. Soft female lead, close and breathy, light harmonies in the chorus. Fingerpicked guitar and soft piano; brushed drums and upright bass enter in the chorus.",
  "duration": "120",
  "lyrics": "[verse]\nMorning light filtering through the pine\nEvery quiet street is yours and mine\n[chorus]\nSoftly the world begins to breathe",
  "model_id": "minimax-music-3"
}' | 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('minimax_music', {
  prompt: 'Acoustic pop, 96 BPM, C major, warm and intimate, building into the chorus. Soft female lead, close and breathy, light harmonies in the chorus. Fingerpicked guitar and soft piano; brushed drums and upright bass enter in the chorus.',
  duration: '120',
  lyrics: '[verse]\nMorning light filtering through the pine\nEvery quiet street is yours and mine\n[chorus]\nSoftly the world begins to breathe',
  model_id: 'minimax-music-3',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("minimax_music", {
    "prompt": "Acoustic pop, 96 BPM, C major, warm and intimate, building into the chorus. Soft female lead, close and breathy, light harmonies in the chorus. Fingerpicked guitar and soft piano; brushed drums and upright bass enter in the chorus.",
    "duration": "120",
    "lyrics": "[verse]\nMorning light filtering through the pine\nEvery quiet street is yours and mine\n[chorus]\nSoftly the world begins to breathe",
    "model_id": "minimax-music-3",
})

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

مدل‌ها

مقادیر model_id برای MiniMax Music 3

برای انتخاب یک نسخه، model_id را بفرستید. درخواست بدون آن، نسخه پیش‌فرض را اجرا می‌کند.

model_idنامپیش‌فرض
minimax-music-3MiniMax Music 3بله

گزینه‌ها

پارامترهای MiniMax Music 3

مقادیر مجاز برای همه نسخه‌ها؛ ممکن است یک نسخه گزینه‌های کمتری داشته باشد. گزینه‌های هر نسخه در مستندات آمده است.

فیلدمقادیر
duration30, 60, 120, 180, 240, 300

قوانین

محدودیت‌های API مدل MiniMax Music 3

  • پرامپت موسیقی را توصیف می‌کند، حداکثر 4000 نویسه: سبک، تمپو و گام، حال‌وهوا و نحوه‌ی اوج گرفتن، خواننده (صدا را نام ببرید، وگرنه ممکن است آهنگ بی‌کلام شود) و سازها.
  • `lyrics` شامل کلماتی است که خوانده می‌شود، حداکثر 6000 نویسه. هر برچسب بخش ([intro]، [verse]، [pre-chorus]، [chorus]، [bridge]، [outro]) را در یک خط جدا بنویسید: کلماتی که در خط برچسب باشند حذف می‌شوند.
  • برای قطعه‌ی بی‌کلام، `lyrics` را خالی بگذارید یا `instrumental` را روی true بگذارید.
  • `duration` بیشینه‌ی طول آهنگ و مبنای قیمت است؛ مدل وقتی ترانه و تنظیم تمام شد آهنگ را تمام می‌کند، که اغلب زودتر است.

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

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

  • صدا · از ۱۹ Gem

    Seed Audio API

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

  • صدا · از ۱۱۳ Gem

    API ‏Eleven Music

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

  • صدا · از ۳۰ Gem

    Eleven Speech API

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

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

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

API مدل MiniMax Music 3 چقدر هزینه دارد؟
یک درخواست MiniMax Music 3 با تنظیمات پیش‌فرض (MiniMax Music 3) 125 Gems هزینه دارد، حدود 0.125 دلار. وضوح، مدت و نسخه‌های دیگر قیمت را تغییر می‌دهند؛ پاسخ، هزینه‌ی دقیق را اعلام می‌کند. تولیدی که ناموفق باشد بازپرداخت می‌شود؛ تولیدی که سیاست محتوای Mage مانع آن شود بازپرداخت نمی‌شود.
نقطه‌ی پایانی API مدل MiniMax Music 3 چیست؟
POST https://api.mage.space/v1/minimax_music/generate همراه با هدر Authorization: Bearer که کلید API شما در Mage را دارد. پاسخ شامل یک status_url است که برای دریافت نتیجه باید بررسی شود.
کدام مدل‌های MiniMax Music 3 را می‌توانم فراخوانی کنم؟
minimax-music-3 (MiniMax Music 3). پیش‌فرض MiniMax Music 3 است.
آیا MiniMax Music 3 از تصویر مرجع یا شخصیت پشتیبانی می‌کند؟
MiniMax Music 3 ورودی تصویر، ویدیو یا صدا نمی‌گیرد. MiniMax Music 3 از اشاره‌ی @handle پشتیبانی نمی‌کند.
آیا می‌توانم از MiniMax Music 3 در Claude یا ChatGPT استفاده کنم؟
بله. سرور MCP مربوط به Mage را به Claude، ChatGPT، Claude Code، Grok یا Cursor وصل کنید و MiniMax Music 3 را با نام بخواهید. دستیار شما گزینه‌های آن را با get_model می‌خواند و پیش از تولید، قیمت را اعلام می‌کند.
نتایج MiniMax Music 3 تا چه مدت نگه‌داری می‌شوند؟
نتایج و ورودی‌ها 30 روز نگهداری می‌شوند. هر چیزی را که می‌خواهید نگه دارید، در فضای ذخیره‌سازی خودتان دانلود کنید.

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

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

Charactersانجمن