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-3 | MiniMax Music 3 | نعم |
الخيارات
معاملات MiniMax Music 3
القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.
| الحقل | القيم |
|---|---|
| duration | 30, 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
واجهة Seed Audio API
أصوات وموسيقى ومؤثرات صوتية من أمر واحد
Eleven Music API
أغانٍ من ElevenLabs، بأصوات غنائية أو بدونها
واجهة Eleven Speech API
ElevenLabs v4: كلام واقعي يمكنك توجيهه
الأسئلة الشائعة
الأسئلة الشائعة
كم تكلّف MiniMax Music 3 API؟
ما نقطة نهاية MiniMax Music 3 API؟
أي نماذج MiniMax Music 3 يمكنني استدعاؤها؟
هل يدعم MiniMax Music 3 الصور المرجعية أو الشخصيات؟
هل يمكنني استخدام MiniMax Music 3 من Claude أو ChatGPT؟
إلى متى تُحفظ نتائج MiniMax Music 3؟
ابدأ البناء مع Mage
حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.