MiniMax: Music 2.5+
يولّد MiniMax Music 2.5+ الموسيقى من prompt للأسلوب والأجواء وكلمات أغنية مقدّمة. يقبل ملفه الموسيقي المتزامن 10–2,000 محرف في prompt و10–3,500 محرف لكلمات الأغنية، ومخرج MP3 أو WAV.
- Ailoot Ultra · Music
POST /v1/music/generationsminimax/music-2.5+ - Ailoot Ultra · Music
POST /v1/music/generationsmusic-2.5+
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
ينشئ MiniMax Music 2.5+ الموسيقى انطلاقًا من موجز موسيقي مكتوب وكلمات أغنية. اختر minimax/music-2.5+ لهذه النسخة تحديدًا؛ وmusic-2.5+ هو اسمها البديل المهيأ. تستخدم طريقته الموسيقية طلب JSON مع model وprompt وlyrics وتنتج صوتًا مولّدًا. استخدمه لتحويل تصور مكتوب لأغنية إلى مسودة للاستماع، أو تلحين كلمات مقدّمة، أو استكشاف تكوين قبل مواصلة التحرير.
استخدم prompt لوصف الأسلوب الموسيقي والأجواء والبيئة، وlyrics للكلمات التي ستُغنّى. قد يطلب موجز مفيد أغنية فولك تأملية لمقهى هادئ، مع مقطع يؤسس المشهد ولازمة تكرر فكرته المحورية. أبقِ التوجه الموسيقي في prompt والأسطر المقصودة في lyrics حتى يكون للنص دور واضح في التكوين.
بالنسبة إلى Music 2.5+، يجب أن يحتوي prompt على 10–2,000 محرف، وأن تحتوي lyrics على 10–3,500 محرف. أدرج الحقلين النصيين في الطلب مع النموذج المختار. استخدم مساحة prompt للاختيارات الموسيقية المهمة، ثم قدّم الكلمات المقصودة كاملة في lyrics. يسهل مقارنة موجز مختصر لكنه كامل بالأغنية المُعادة أكثر من تعليمات غير مترابطة موزعة بين الحقلين.
افصل أسطر كلمات الأغنية بمحارف السطر الجديد. يمكن لتسميات الأقسام مثل [Intro] و[Verse] و[Pre Chorus] و[Chorus] و[Bridge] و[Outro] أن تحدد البنية المقصودة؛ وتتضمن المجموعة الموثّقة أيضًا [Interlude] و[Post Chorus] و[Transition] و[Break] و[Hook] و[Build Up] و[Inst] و[Solo]. ضع الكلمات الفعلية تحت تسميات أقسامها واجعل تكرار الأقسام مقصودًا. تمنح هذه العلامات التكوين بنية ينطلق منها؛ راجع كيف تحقق الأغنية المكتملة الانتقالات والتكرارات فعلًا.
يوفّر كائن audio_setting قيم sample_rate البالغة 16000 أو 24000 أو 32000 أو 44100، وقيم bitrate البالغة 32000 أو 64000 أو 128000 أو 256000، وقيم format وهي mp3 أو wav. اختر إعدادات الملف لخطوة التحرير أو التشغيل التالية واحتفظ بها مع الموجز. يطلب المثال المنشور 44100 و256000 وmp3؛ وهي اختيارات توضيحية وليست قيمًا افتراضية عامة للحقول الثلاثة كلها.
مسار العمل الموسيقي المختار متزامن وغير متدفق. خيارات output_format الموثّقة هي url وhex، مع hex كقيمة افتراضية في المخطط؛ ويطلب المثال المختار url صراحة. ولمخرج URL، استخدم رابط Ailoot المُعاد لتنزيل الصوت المحفوظ. تمثّل نتيجة hex بايتات صوت يجب فك ترميزها إلى صيغة الملف المختارة قبل التشغيل. قد تحتوي الاستجابة على موضعي audio وaudio_url لصوت مولّد واحد؛ احتفظ بتلك النتيجة كأغنية واحدة.
احفظ الصوت المكتمل مع كلماته وموجزه الموسيقي ومعرّف النموذج الدقيق وإعدادات الملف المطلوبة. استمع للتحقق من الكلمات المقصودة وترتيب الأقسام والتوجه الموسيقي قبل وضعه في مشروع. إذا انتهى الطلب دون نتيجة كاملة، فاحتفظ بهوية طلبه الأصلي ومعلومات الاستجابة لفحص النتيجة؛ إذ قد ينشئ طلب بديل تلقائي أغنية أخرى. يمكن للمراجعة أن تغيّر كلمات معينة أو تعليمة موسيقية محددة مع الحفاظ على بقية الموجز للمقارنة.
Ailoot Ultra · Music POST /v1/music/generations minimax/music-2.5+
minimax/music-2.5+minimax/music-2.5+music-2.5+
البداية
يولّد MiniMax Music 2.5+ الموسيقى من prompt للأسلوب والأجواء وكلمات أغنية مقدّمة. يقبل ملفه الموسيقي المتزامن 10–2,000 محرف في prompt و10–3,500 محرف لكلمات الأغنية، ومخرج MP3 أو WAV.
- المدخلات المقبولة
- النص
- النتائج
- الصوت
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · Music POST /v1/music/generations
- الإدخال
text- الإخراج
audio- صيغة الإخراج
- mp3,wav
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود minimax/music-2.5+ | القيمة الافتراضية— |
الحقلprompt | النوعstring | المتطلبمطلوب | القيم والحدود | القيمة الافتراضية— |
الحقلlyrics | النوعstring | المتطلبمطلوب | القيم والحدود | القيمة الافتراضية— |
الحقلstream | النوعboolean | المتطلباختياري | القيم والحدود false | القيمة الافتراضيةfalse |
الحقلoutput_format | النوعstring | المتطلباختياري | القيم والحدود url, hex | القيمة الافتراضيةhex |
الحقلaudio_setting | النوعobject | المتطلباختياري | القيم والحدود | القيمة الافتراضية— |
الحقلaudio_setting.sample_rate | النوعinteger | المتطلباختياري | القيم والحدود 16,000, 24,000, 32,000, 44,100 | القيمة الافتراضية— |
الحقلaudio_setting.bitrate | النوعinteger | المتطلباختياري | القيم والحدود 32,000, 64,000, 128,000, 256,000 | القيمة الافتراضية— |
الحقلaudio_setting.format | النوعstring | المتطلباختياري | القيم والحدود mp3, wav | القيمة الافتراضية— |
الحقلaigc_watermark | النوعboolean | المتطلباختياري | القيم والحدود | القيمة الافتراضيةfalse |
معلمات الطريقة ودورة حياتها
| المعلمة | المواصفات |
|---|---|
المعلمةcontent_type | المواصفاتapplication/json |
المعلمةrequired | المواصفاتmodel, prompt, lyrics |
المعلمةoptional | المواصفاتstream, output_format, audio_setting, aigc_watermark |
المعلمةmaterial_types | المواصفاتtext |
المعلمةconditions | المواصفاتUse a nonstreaming request. MP3 and WAV are available; a PCM control is absent from this method. |
دورة الحياة: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
الباقات
مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.
- الوضع السريع
- غير محدد عند اختيار الوضع السريع
- الوضع المرن
- غير محدد عند اختيار وضع flex
- أقصى جهد للاستدلال
- غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال
تعرفات Ailoot
الأسعار حسب الإعدادات
طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.
| الإعدادات | جدول التعرفة | كمية الفوترة | الرسوم |
|---|---|---|---|
| الإعداداتالتعرفات الأساسية للرموز | جدول التعرفةالتعرفة الأساسية | كمية الفوترة— | الرسوم الإدخال · رموز الإدخال — / 1K من الرموز الإخراج · رموز الإخراج — / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة — / 1K من الرموز |
| الإعداداتلكل طلب | جدول التعرفة— | كمية الفوترةطلب واحد | الرسوم الإدخال $0.3 لكل طلب |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
أمثلة للطلبات
Ailoot Ultra · Music
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "minimax/music-2.5+", "prompt": "独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆", "lyrics": "[verse]\\n街灯微亮晚风轻抚\\n影子拉长独自漫步\\n旧外套裹着深深忧郁\\n不知去向渴望何处\\n[chorus]\\n推开木门香气弥漫\\n熟悉的角落陌生人看", "audio_setting": {"sample_rate": 44100, "bitrate": 256000, "format": "mp3"}, "output_format": "url"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
استلام النتائج وحفظها
Ailoot Ultra · Music
mp3,wav
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
الاحتفاظ بكل النتائج المكتملة
احتفظ بكل استجابة كاملة وكل ملف وجزء محتوى تم إرجاعه.
One generated audio; retain every returned field. audio and audio_url are representations of the same output, not separate songs.
عند الحاجة إلى التحقق من الاستجابة الأصلية
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
حقول الاستجابة
| الحقل | النوع |
|---|---|
الحقلdata.audio | النوعstring |
الحقلdata.audio_url | النوعstring |
الحقلdata.status | النوعinteger |
الأسماء البديلة
الأسماء البديلة للنموذج
Ailoot Ultra minimax/music-2.5+, music-2.5+
الأسماء البديلة لمسارات الطرائق
استخدم مسارات الطرائق المعروضة أعلاه.
معرّفات النماذج ذات الصلة IDs
Ailoot Ultra · Music POST /v1/music/generations music-2.5+
music-2.5+minimax/music-2.5+music-2.5+
البداية
يولّد MiniMax Music 2.5+ الموسيقى من prompt للأسلوب والأجواء وكلمات أغنية مقدّمة. يقبل ملفه الموسيقي المتزامن 10–2,000 محرف في prompt و10–3,500 محرف لكلمات الأغنية، ومخرج MP3 أو WAV.
- المدخلات المقبولة
- النص
- النتائج
- الصوت
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · Music POST /v1/music/generations
- الإدخال
text- الإخراج
audio- صيغة الإخراج
- mp3,wav
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود music-2.5+ | القيمة الافتراضية— |
الحقلprompt | النوعstring | المتطلبمطلوب | القيم والحدود | القيمة الافتراضية— |
الحقلlyrics | النوعstring | المتطلبمطلوب | القيم والحدود | القيمة الافتراضية— |
الحقلstream | النوعboolean | المتطلباختياري | القيم والحدود false | القيمة الافتراضيةfalse |
الحقلoutput_format | النوعstring | المتطلباختياري | القيم والحدود url, hex | القيمة الافتراضيةhex |
الحقلaudio_setting | النوعobject | المتطلباختياري | القيم والحدود | القيمة الافتراضية— |
الحقلaudio_setting.sample_rate | النوعinteger | المتطلباختياري | القيم والحدود 16,000, 24,000, 32,000, 44,100 | القيمة الافتراضية— |
الحقلaudio_setting.bitrate | النوعinteger | المتطلباختياري | القيم والحدود 32,000, 64,000, 128,000, 256,000 | القيمة الافتراضية— |
الحقلaudio_setting.format | النوعstring | المتطلباختياري | القيم والحدود mp3, wav | القيمة الافتراضية— |
الحقلaigc_watermark | النوعboolean | المتطلباختياري | القيم والحدود | القيمة الافتراضيةfalse |
معلمات الطريقة ودورة حياتها
| المعلمة | المواصفات |
|---|---|
المعلمةcontent_type | المواصفاتapplication/json |
المعلمةrequired | المواصفاتmodel, prompt, lyrics |
المعلمةoptional | المواصفاتstream, output_format, audio_setting, aigc_watermark |
المعلمةmaterial_types | المواصفاتtext |
المعلمةconditions | المواصفاتUse a nonstreaming request. MP3 and WAV are available; a PCM control is absent from this method. |
دورة الحياة: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
الباقات
مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.
- الوضع السريع
- غير محدد عند اختيار الوضع السريع
- الوضع المرن
- غير محدد عند اختيار وضع flex
- أقصى جهد للاستدلال
- غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال
تعرفات Ailoot
الأسعار حسب الإعدادات
طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.
| الإعدادات | جدول التعرفة | كمية الفوترة | الرسوم |
|---|---|---|---|
| الإعداداتالتعرفات الأساسية للرموز | جدول التعرفةالتعرفة الأساسية | كمية الفوترة— | الرسوم الإدخال · رموز الإدخال — / 1K من الرموز الإخراج · رموز الإخراج — / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة — / 1K من الرموز |
| الإعداداتلكل طلب | جدول التعرفة— | كمية الفوترةطلب واحد | الرسوم الإدخال $0.3 لكل طلب |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
أمثلة للطلبات
Ailoot Ultra · Music
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "music-2.5+", "prompt": "独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆", "lyrics": "[verse]\\n街灯微亮晚风轻抚\\n影子拉长独自漫步\\n旧外套裹着深深忧郁\\n不知去向渴望何处\\n[chorus]\\n推开木门香气弥漫\\n熟悉的角落陌生人看", "audio_setting": {"sample_rate": 44100, "bitrate": 256000, "format": "mp3"}, "output_format": "url"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
استلام النتائج وحفظها
Ailoot Ultra · Music
mp3,wav
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
الاحتفاظ بكل النتائج المكتملة
احتفظ بكل استجابة كاملة وكل ملف وجزء محتوى تم إرجاعه.
One generated audio; retain every returned field. audio and audio_url are representations of the same output, not separate songs.
عند الحاجة إلى التحقق من الاستجابة الأصلية
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
حقول الاستجابة
| الحقل | النوع |
|---|---|
الحقلdata.audio | النوعstring |
الحقلdata.audio_url | النوعstring |
الحقلdata.status | النوعinteger |
الأسماء البديلة
الأسماء البديلة للنموذج
Ailoot Ultra minimax/music-2.5+, music-2.5+
الأسماء البديلة لمسارات الطرائق
استخدم مسارات الطرائق المعروضة أعلاه.
معرّفات النماذج ذات الصلة IDs
FAQ · MiniMax: Music 2.5+
- ما المدخلات والنتائج المتاحة؟
POST /v1/music/generations·minimax/music-2.5+:text→audioPOST /v1/music/generations·music-2.5+:text→audio- ما الحقول التي يستخدمها الطلب؟
POST /v1/music/generations·minimax/music-2.5+:model,prompt,lyrics,stream,output_format,audio_setting,aigc_watermarkPOST /v1/music/generations·music-2.5+:model,prompt,lyrics,stream,output_format,audio_setting,aigc_watermark