انتقل إلى المحتوى

Mage API · نموذج صوتي

MiniMax Music 3 API

أغانٍ كاملة من كلماتك، بأوزان مفتوحة

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

لمحة سريعة

تشغّل MiniMax Music 3 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التكلفة التقريبية بالدولار

نظرة عامة

ماذا تقدّم MiniMax Music 3 API

نموذج الأغاني المفتوح من MiniMax: أغانٍ كاملة تصل إلى 5 دقائق بأصوات تغنّي كلماتك، أو مقطوعات موسيقية بلا غناء، تتشكّل من وصف للنمط والصوت والتوزيع. مع دعم LoRAs.

نموذج الأغاني مفتوح الأوزان من MiniMax: أغانٍ كاملة بأصوات تغنّي كلماتك، أو مقطوعات موسيقية بلا غناء، حتى 5 دقائق، بصيغة MP3 ستيريو 44.1 kHz، مع دعم LoRAs. ضع الكلمات في `lyrics` ووصف الصوت في الـprompt.

يُنشئ الصورة من الوصف النصي فقط.

بداية سريعة

استدعاء MiniMax Music 3 API

عيّن 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

القواعد

ما الذي تفرضه MiniMax Music 3 API

  • يصف الـprompt الموسيقى بما لا يزيد على 4000 حرف: النمط، والإيقاع والمقام، والمزاج وكيف يتصاعد، والمغنّي (سمِّ الصوت، وإلا قد تأتي المقطوعة بلا غناء)، والآلات.
  • يحتوي `lyrics` على الكلمات المراد غناؤها بما لا يزيد على 6000 حرف. ضع كل وسم قسم ([intro] و[verse] و[pre-chorus] و[chorus] و[bridge] و[outro]) في سطر مستقل: الكلمات الموجودة في سطر الوسم تُحذف.
  • اترك `lyrics` فارغًا، أو اضبط `instrumental` على true، للحصول على مقطوعة موسيقية بلا غناء.
  • `duration` هي أطول مدة قد تستغرقها الأغنية، وعليها يُحتسب السعر؛ ينهي النموذج الأغنية عند اكتمال كلماتها وتوزيعها، وغالبًا ما يكون ذلك أبكر.

المزيد من النماذج الصوتية

واجهات توليد الصوت الأخرى على Mage

  • صوت · من 19 Gems

    واجهة Seed Audio API

    أصوات وموسيقى ومؤثرات صوتية من أمر واحد

  • صوت · من 113 Gems

    Eleven Music API

    أغانٍ من ElevenLabs، بأصوات غنائية أو بدونها

  • صوت · بدءًا من 30 Gems

    واجهة Eleven Speech API

    ElevenLabs v4: كلام واقعي يمكنك توجيهه

الأسئلة الشائعة

الأسئلة الشائعة

كم تكلّف MiniMax Music 3 API؟
يكلّف طلب MiniMax Music 3 بالإعدادات الافتراضية (MiniMax Music 3) ‏125 Gems، أي نحو $0.125. تغيّر الدقة والمدة والإصدارات الأخرى السعر؛ وتذكر الاستجابة الرسوم الدقيقة. تُسترد تكلفة عملية التوليد الفاشلة، أما العملية التي تحظرها سياسة المحتوى في Mage فلا تُسترد.
ما نقطة نهاية MiniMax Music 3 API؟
POST https://api.mage.space/v1/minimax_music/generate مع ترويسة Authorization: Bearer تحمل مفتاح Mage API الخاص بك. تتضمن الاستجابة 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؟
نعم. اربط خادم Mage MCP بـ Claude أو ChatGPT أو Claude Code أو Grok أو Cursor واطلب MiniMax Music 3 بالاسم. يقرأ مساعدك خياراته عبر get_model ويذكر السعر قبل التوليد.
إلى متى تُحفظ نتائج MiniMax Music 3؟
يُحتفظ بالنتائج والمدخلات لمدة 30 يومًا. نزّل كل ما تريد الاحتفاظ به إلى مساحة التخزين الخاصة بك.

ابدأ البناء مع Mage

حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.

Charactersالمجتمع