{ "aboutHtml": "

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 สำหรับเสียงที่สร้างหนึ่งรายการ ให้เก็บผลลัพธ์นั้นเป็นเพลงเดียว

บันทึกเสียงที่เสร็จแล้วพร้อมเนื้อเพลง บรีฟดนตรี ID โมเดลที่ตรงตามชื่อ และการตั้งค่าไฟล์ที่ร้องขอ ฟังเพื่อตรวจเนื้อร้อง ลำดับท่อน และแนวทางดนตรีที่ต้องการก่อนใส่ลงในโครงการ หากคำขอสิ้นสุดโดยไม่ได้ผลลัพธ์ครบถ้วน ให้เก็บข้อมูลระบุตัวตนของคำขอเดิมและข้อมูลการตอบกลับเพื่อตรวจผลลัพธ์ คำขอทดแทนอัตโนมัติอาจสร้างเพลงอีกเพลง การแก้ไขสามารถเปลี่ยนเนื้อร้องหรือคำสั่งดนตรีเฉพาะจุด โดยคงส่วนที่เหลือของบรีฟไว้สำหรับเปรียบเทียบ

", "aboutText": "MiniMax Music 2.5+ สร้างเพลงจากบรีฟดนตรีเป็นข้อความและเนื้อเพลง เลือก minimax/music-2.5+ สำหรับรุ่นนี้โดยเฉพาะ โดย music-2.5+ เป็น ชื่อเรียกอีกแบบ ที่กำหนดไว้ เมธอดเพลงใช้คำขอ JSON ที่มี model, prompt และ lyrics แล้วสร้างเสียงผลลัพธ์ ใช้เปลี่ยนแนวคิดเพลงที่เขียนไว้เป็นร่างสำหรับฟัง ใส่ดนตรีให้เนื้อเพลงที่ป้อน หรือสำรวจบทประพันธ์ก่อนแก้ไขต่อ\n\nใช้ prompt อธิบายแนวดนตรี อารมณ์ และบรรยากาศ ส่วน lyrics ใช้สำหรับคำที่จะร้อง บรีฟที่มีประโยชน์อาจขอเพลงโฟล์กที่ครุ่นคิดสำหรับคาเฟ่เงียบ ๆ โดยมีท่อนเวิร์ส ที่ปูฉากและท่อนคอรัส ที่ย้ำแนวคิดหลัก เก็บแนวทางดนตรีไว้ใน prompt และบรรทัดเนื้อร้องที่ต้องการไว้ใน lyrics เพื่อให้ข้อความมีบทบาทในบทเพลงชัดเจน\n\nสำหรับ Music 2.5+ ค่า prompt ต้องมี 10–2,000 อักขระ และ lyrics ต้องมี 10–3,500 อักขระ ใส่ฟิลด์ข้อความทั้งสองในคำขอพร้อมโมเดลที่เลือก ใช้พื้นที่ prompt สำหรับการเลือกทางดนตรีที่สำคัญ แล้วใส่เนื้อร้องที่ต้องการทั้งหมดไว้ใน lyrics บรีฟที่กระชับแต่ครบถ้วนเปรียบเทียบกับเพลงที่ส่งกลับมาได้ง่ายกว่าคำสั่งที่ไม่เกี่ยวข้องกันซึ่งกระจายอยู่ทั้งสองฟิลด์\n\nแบ่งบรรทัดเนื้อเพลงด้วยอักขระขึ้นบรรทัดใหม่ ป้ายชื่อท่อน เช่น [Intro], [Verse], [Pre Chorus], [Chorus], [Bridge] และ [Outro] ใช้ระบุโครงสร้างที่ต้องการได้ ชุดตามเอกสารยังมี [Interlude], [Post Chorus], [Transition], [Break], [Hook], [Build Up], [Inst] และ [Solo] ใส่เนื้อร้องจริงใต้ป้ายชื่อท่อนและกำหนดท่อนซ้ำอย่างตั้งใจ เครื่องหมายเหล่านี้ให้โครงสร้างสำหรับแต่งเพลง โดยควรตรวจทานว่าเพลงที่เสร็จแล้วทำการเปลี่ยนท่อนและการซ้ำจริงอย่างไร\n\nออบเจ็กต์ audio_setting มีค่า sample_rate เป็น 16000, 24000, 32000 หรือ 44100 ค่า bitrate เป็น 32000, 64000, 128000 หรือ 256000 และค่า format เป็น mp3 หรือ wav เลือกการตั้งค่าไฟล์ให้เหมาะกับขั้นตอนตัดต่อหรือเล่นกลับถัดไป และเก็บไว้พร้อมบรีฟ ตัวอย่างที่เผยแพร่ร้องขอ 44100, 256000 และ mp3 ซึ่งเป็นค่าที่เลือกในตัวอย่าง ไม่ใช่ค่าเริ่มต้นสากลสำหรับทั้งสามฟิลด์\n\nกระบวนการเพลงที่เลือกเป็นแบบซิงโครนัสและไม่สตรีม ตัวเลือก output_format ตามเอกสารคือ url และ hex โดย hex เป็นค่าเริ่มต้นในสคีมา ส่วนตัวอย่างที่เลือกร้องขอ url อย่างชัดเจน สำหรับเอาต์พุต URL ให้ใช้ลิงก์ Ailoot ที่ส่งกลับมาเพื่อดาวน์โหลดเสียงที่บันทึกไว้ ผลลัพธ์ hex แทนไบต์เสียงที่ต้องถอดรหัสเป็นรูปแบบไฟล์ที่เลือกก่อนเล่น การตอบกลับอาจมีทั้งตำแหน่ง audio และ audio_url สำหรับเสียงที่สร้างหนึ่งรายการ ให้เก็บผลลัพธ์นั้นเป็นเพลงเดียว\n\nบันทึกเสียงที่เสร็จแล้วพร้อมเนื้อเพลง บรีฟดนตรี ID โมเดลที่ตรงตามชื่อ และการตั้งค่าไฟล์ที่ร้องขอ ฟังเพื่อตรวจเนื้อร้อง ลำดับท่อน และแนวทางดนตรีที่ต้องการก่อนใส่ลงในโครงการ หากคำขอสิ้นสุดโดยไม่ได้ผลลัพธ์ครบถ้วน ให้เก็บข้อมูลระบุตัวตนของคำขอเดิมและข้อมูลการตอบกลับเพื่อตรวจผลลัพธ์ คำขอทดแทนอัตโนมัติอาจสร้างเพลงอีกเพลง การแก้ไขสามารถเปลี่ยนเนื้อร้องหรือคำสั่งดนตรีเฉพาะจุด โดยคงส่วนที่เหลือของบรีฟไว้สำหรับเปรียบเทียบ", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "7990f0c63a71ae0341f83a8f5cf8e29a747b1b014a3f2073dcc6c882defd8e0d", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "th", "methods": [ { "html": "
MM

MiniMax: Music 2.5+

MiniMax /minimax/music-2.5+

เริ่มต้น

MiniMax Music 2.5+ สร้างเพลงจาก prompt ที่ระบุแนวเพลงและอารมณ์ พร้อมเนื้อเพลงที่ป้อนให้ โปรไฟล์เพลงแบบซิงโครนัสรับ prompt 10–2,000 อักขระ เนื้อเพลง 10–3,500 อักขระ และเอาต์พุต MP3 หรือ WAV

อินพุตที่รองรับ
ข้อความ
ผลลัพธ์
เสียง
เกี่ยวกับโมเดล

คำอธิบายนี้ครอบคลุมความสามารถของโมเดล อินพุต เอาต์พุต และตัวเลือกที่ใช้ได้ใน 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 สำหรับเสียงที่สร้างหนึ่งรายการ ให้เก็บผลลัพธ์นั้นเป็นเพลงเดียว

บันทึกเสียงที่เสร็จแล้วพร้อมเนื้อเพลง บรีฟดนตรี ID โมเดลที่ตรงตามชื่อ และการตั้งค่าไฟล์ที่ร้องขอ ฟังเพื่อตรวจเนื้อร้อง ลำดับท่อน และแนวทางดนตรีที่ต้องการก่อนใส่ลงในโครงการ หากคำขอสิ้นสุดโดยไม่ได้ผลลัพธ์ครบถ้วน ให้เก็บข้อมูลระบุตัวตนของคำขอเดิมและข้อมูลการตอบกลับเพื่อตรวจผลลัพธ์ คำขอทดแทนอัตโนมัติอาจสร้างเพลงอีกเพลง การแก้ไขสามารถเปลี่ยนเนื้อร้องหรือคำสั่งดนตรีเฉพาะจุด โดยคงส่วนที่เหลือของบรีฟไว้สำหรับเปรียบเทียบ

ใช้งานได้ใน 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\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=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"}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\n# Submit once. Retain the complete result, original identifiers and every response header.\n

รับและบันทึกผลลัพธ์

Ailoot Ultra · Music

mp3,wav

เก็บผลลัพธ์ที่เสร็จสมบูรณ์ทั้งหมด

เก็บทุกการตอบกลับ ไฟล์ และส่วนเนื้อหาที่ส่งกลับมาอย่างครบถ้วน

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+

ชื่อพาธเมธอดอื่น

ใช้พาธเมธอดที่แสดงด้านบน

ID ที่เกี่ยวข้องสำหรับเรียกใช้โมเดล

minimax/music-2.5+, music-2.5+

", "method_identity": { "effective_request_model_id": "minimax/music-2.5+", "fmt": "music", "http": "POST", "path": "/v1/music/generations", "request_model_id": "minimax/music-2.5+", "route_label": "Ultra" }, "method_key": "Ultra|music|/v1/music/generations|minimax%2Fmusic-2.5%2B", "ordinal": 0, "rawMethod": { "available": null, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response, all actual results, original identifiers, usage and response headers.", "authentication": { "api_key_source": "AILOOT_API_KEY", "header": "Authorization: Bearer" }, "example_body": { "audio_setting": { "bitrate": 256000, "format": "mp3", "sample_rate": 44100 }, "lyrics": "[verse]\n街灯微亮晚风轻抚\n影子拉长独自漫步\n旧外套裹着深深忧郁\n不知去向渴望何处\n[chorus]\n推开木门香气弥漫\n熟悉的角落陌生人看", "model": "minimax/music-2.5+", "output_format": "url", "prompt": "独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆" }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "audio" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/music/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "outputs": { "all_results": "One generated audio; retain every returned field. audio and audio_url are representations of the same output, not separate songs.", "family": "audio", "fields": [ { "name": "data.audio", "type": "string" }, { "name": "data.audio_url", "type": "string" }, { "name": "data.status", "type": "integer" } ], "format": [ "mp3", "wav" ] }, "parameters": [ { "default_known": false, "enum": [ "minimax/music-2.5+" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "default_known": false, "enum_known": false, "maxLength": 2000, "minLength": 10, "name": "prompt", "required": true, "type": "string" }, { "default_known": false, "enum_known": false, "maxLength": 3500, "minLength": 10, "name": "lyrics", "required": true, "type": "string" }, { "default": false, "default_known": true, "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" }, { "default": "hex", "default_known": true, "enum": [ "url", "hex" ], "enum_known": true, "name": "output_format", "required": false, "type": "string" }, { "additionalProperties": false, "default_known": false, "enum_known": false, "name": "audio_setting", "properties": { "bitrate": { "enum": [ 32000, 64000, 128000, 256000 ], "type": "integer" }, "format": { "enum": [ "mp3", "wav" ], "type": "string" }, "sample_rate": { "enum": [ 16000, 24000, 32000, 44100 ], "type": "integer" } }, "required": false, "type": "object" }, { "default_known": false, "enum": [ 16000, 24000, 32000, 44100 ], "enum_known": true, "name": "audio_setting.sample_rate", "required": false, "type": "integer" }, { "default_known": false, "enum": [ 32000, 64000, 128000, 256000 ], "enum_known": true, "name": "audio_setting.bitrate", "required": false, "type": "integer" }, { "default_known": false, "enum": [ "mp3", "wav" ], "enum_known": true, "name": "audio_setting.format", "required": false, "type": "string" }, { "default": false, "default_known": true, "enum_known": false, "name": "aigc_watermark", "required": false, "type": "boolean" } ], "request_schema": { "additionalProperties": false, "properties": { "aigc_watermark": { "default": false, "type": "boolean" }, "audio_setting": { "additionalProperties": false, "properties": { "bitrate": { "enum": [ 32000, 64000, 128000, 256000 ], "type": "integer" }, "format": { "enum": [ "mp3", "wav" ], "type": "string" }, "sample_rate": { "enum": [ 16000, 24000, 32000, 44100 ], "type": "integer" } }, "type": "object" }, "lyrics": { "maxLength": 3500, "minLength": 10, "type": "string" }, "model": { "enum": [ "minimax/music-2.5+" ], "type": "string" }, "output_format": { "default": "hex", "enum": [ "url", "hex" ], "type": "string" }, "prompt": { "maxLength": 2000, "minLength": 10, "type": "string" }, "stream": { "default": false, "enum": [ false ], "type": "boolean" } }, "required": [ "model", "prompt", "lyrics" ], "type": "object" }, "schema_template": { "body": { "audio_setting": { "bitrate": 256000, "format": "mp3", "sample_rate": 44100 }, "lyrics": "[verse]\n街灯微亮晚风轻抚\n影子拉长独自漫步\n旧外套裹着深深忧郁\n不知去向渴望何处\n[chorus]\n推开木门香气弥漫\n熟悉的角落陌生人看", "model": "minimax/music-2.5+", "output_format": "url", "prompt": "独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆" }, "content_type": "application/json" } }, "input": { "conditions": [ "Use a nonstreaming request. MP3 and WAV are available; a PCM control is absent from this method." ], "content_type": "application/json", "material_types": [ "text" ], "optional": [ "stream", "output_format", "audio_setting", "aigc_watermark" ], "required": [ "model", "prompt", "lyrics" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "audio" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/music/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "method": { "http": "POST", "path": "/v1/music/generations" }, "method_aliases": [], "output": { "all_results": "One generated audio; retain every returned field. audio and audio_url are representations of the same output, not separate songs.", "family": "audio", "fields": [ { "name": "data.audio", "type": "string" }, { "name": "data.audio_url", "type": "string" }, { "name": "data.status", "type": "integer" } ], "format": [ "mp3", "wav" ] } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_quantity": "one request" }, "label": "Per request", "units": [ { "amount": "0.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": true, "estimate_only": false, "key": "per_request", "label": "per request", "native_amount_usd_per_unit": "0.3", "native_quantity": 1, "public_unit_label": "per request", "quantity": 1, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "per_request" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=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\"}')\n\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\n# Submit once. Retain the complete result, original identifiers and every response header.\n", "label": "curl · create once and retain the complete result", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "music", "http": "POST", "img_in": null, "img_out": null, "in": null, "input": [ "text" ], "label": "Music", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "audio" ], "path": "/v1/music/generations", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "per_request", "cache_read_price": null, "cache_write_1h_price": null, "cache_write_price": null, "fast_multiplier": null, "flex_multiplier": null, "image_input_price": null, "image_output_price": null, "input_price": null, "intervals": [], "max_reasoning_effort_multiplier": null, "output_price": null, "per_request_price": "0.3" }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_quantity": "one request" }, "label": "Per request", "units": [ { "amount": "0.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": true, "estimate_only": false, "key": "per_request", "label": "per request", "native_amount_usd_per_unit": "0.3", "native_quantity": 1, "public_unit_label": "per request", "quantity": 1, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "per_request" } ] } ], "request_model_id": "minimax/music-2.5+", "route_label": "Ultra", "status_reads": [], "tiers": [], "unit": "per_request", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": true, "estimate_only": false, "key": "per_request", "label": "per request", "native_amount_usd_per_unit": "0.3", "native_quantity": 1, "public_unit_label": "per request", "quantity": 1, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "per_request" } ] } }, { "html": "
MM

MiniMax: Music 2.5+

MiniMax /music-2.5+

เริ่มต้น

MiniMax Music 2.5+ สร้างเพลงจาก prompt ที่ระบุแนวเพลงและอารมณ์ พร้อมเนื้อเพลงที่ป้อนให้ โปรไฟล์เพลงแบบซิงโครนัสรับ prompt 10–2,000 อักขระ เนื้อเพลง 10–3,500 อักขระ และเอาต์พุต MP3 หรือ WAV

อินพุตที่รองรับ
ข้อความ
ผลลัพธ์
เสียง
เกี่ยวกับโมเดล

คำอธิบายนี้ครอบคลุมความสามารถของโมเดล อินพุต เอาต์พุต และตัวเลือกที่ใช้ได้ใน 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 สำหรับเสียงที่สร้างหนึ่งรายการ ให้เก็บผลลัพธ์นั้นเป็นเพลงเดียว

บันทึกเสียงที่เสร็จแล้วพร้อมเนื้อเพลง บรีฟดนตรี ID โมเดลที่ตรงตามชื่อ และการตั้งค่าไฟล์ที่ร้องขอ ฟังเพื่อตรวจเนื้อร้อง ลำดับท่อน และแนวทางดนตรีที่ต้องการก่อนใส่ลงในโครงการ หากคำขอสิ้นสุดโดยไม่ได้ผลลัพธ์ครบถ้วน ให้เก็บข้อมูลระบุตัวตนของคำขอเดิมและข้อมูลการตอบกลับเพื่อตรวจผลลัพธ์ คำขอทดแทนอัตโนมัติอาจสร้างเพลงอีกเพลง การแก้ไขสามารถเปลี่ยนเนื้อร้องหรือคำสั่งดนตรีเฉพาะจุด โดยคงส่วนที่เหลือของบรีฟไว้สำหรับเปรียบเทียบ

ใช้งานได้ใน 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\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=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"}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\n# Submit once. Retain the complete result, original identifiers and every response header.\n

รับและบันทึกผลลัพธ์

Ailoot Ultra · Music

mp3,wav

เก็บผลลัพธ์ที่เสร็จสมบูรณ์ทั้งหมด

เก็บทุกการตอบกลับ ไฟล์ และส่วนเนื้อหาที่ส่งกลับมาอย่างครบถ้วน

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+

ชื่อพาธเมธอดอื่น

ใช้พาธเมธอดที่แสดงด้านบน

ID ที่เกี่ยวข้องสำหรับเรียกใช้โมเดล

minimax/music-2.5+, music-2.5+

", "method_identity": { "effective_request_model_id": "music-2.5+", "fmt": "music", "http": "POST", "path": "/v1/music/generations", "request_model_id": "music-2.5+", "route_label": "Ultra" }, "method_key": "Ultra|music|/v1/music/generations|music-2.5%2B", "ordinal": 1, "rawMethod": { "available": null, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response, all actual results, original identifiers, usage and response headers.", "authentication": { "api_key_source": "AILOOT_API_KEY", "header": "Authorization: Bearer" }, "example_body": { "audio_setting": { "bitrate": 256000, "format": "mp3", "sample_rate": 44100 }, "lyrics": "[verse]\n街灯微亮晚风轻抚\n影子拉长独自漫步\n旧外套裹着深深忧郁\n不知去向渴望何处\n[chorus]\n推开木门香气弥漫\n熟悉的角落陌生人看", "model": "music-2.5+", "output_format": "url", "prompt": "独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆" }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "audio" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/music/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "outputs": { "all_results": "One generated audio; retain every returned field. audio and audio_url are representations of the same output, not separate songs.", "family": "audio", "fields": [ { "name": "data.audio", "type": "string" }, { "name": "data.audio_url", "type": "string" }, { "name": "data.status", "type": "integer" } ], "format": [ "mp3", "wav" ] }, "parameters": [ { "default_known": false, "enum": [ "music-2.5+" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "default_known": false, "enum_known": false, "maxLength": 2000, "minLength": 10, "name": "prompt", "required": true, "type": "string" }, { "default_known": false, "enum_known": false, "maxLength": 3500, "minLength": 10, "name": "lyrics", "required": true, "type": "string" }, { "default": false, "default_known": true, "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" }, { "default": "hex", "default_known": true, "enum": [ "url", "hex" ], "enum_known": true, "name": "output_format", "required": false, "type": "string" }, { "additionalProperties": false, "default_known": false, "enum_known": false, "name": "audio_setting", "properties": { "bitrate": { "enum": [ 32000, 64000, 128000, 256000 ], "type": "integer" }, "format": { "enum": [ "mp3", "wav" ], "type": "string" }, "sample_rate": { "enum": [ 16000, 24000, 32000, 44100 ], "type": "integer" } }, "required": false, "type": "object" }, { "default_known": false, "enum": [ 16000, 24000, 32000, 44100 ], "enum_known": true, "name": "audio_setting.sample_rate", "required": false, "type": "integer" }, { "default_known": false, "enum": [ 32000, 64000, 128000, 256000 ], "enum_known": true, "name": "audio_setting.bitrate", "required": false, "type": "integer" }, { "default_known": false, "enum": [ "mp3", "wav" ], "enum_known": true, "name": "audio_setting.format", "required": false, "type": "string" }, { "default": false, "default_known": true, "enum_known": false, "name": "aigc_watermark", "required": false, "type": "boolean" } ], "request_schema": { "additionalProperties": false, "properties": { "aigc_watermark": { "default": false, "type": "boolean" }, "audio_setting": { "additionalProperties": false, "properties": { "bitrate": { "enum": [ 32000, 64000, 128000, 256000 ], "type": "integer" }, "format": { "enum": [ "mp3", "wav" ], "type": "string" }, "sample_rate": { "enum": [ 16000, 24000, 32000, 44100 ], "type": "integer" } }, "type": "object" }, "lyrics": { "maxLength": 3500, "minLength": 10, "type": "string" }, "model": { "enum": [ "music-2.5+" ], "type": "string" }, "output_format": { "default": "hex", "enum": [ "url", "hex" ], "type": "string" }, "prompt": { "maxLength": 2000, "minLength": 10, "type": "string" }, "stream": { "default": false, "enum": [ false ], "type": "boolean" } }, "required": [ "model", "prompt", "lyrics" ], "type": "object" }, "schema_template": { "body": { "audio_setting": { "bitrate": 256000, "format": "mp3", "sample_rate": 44100 }, "lyrics": "[verse]\n街灯微亮晚风轻抚\n影子拉长独自漫步\n旧外套裹着深深忧郁\n不知去向渴望何处\n[chorus]\n推开木门香气弥漫\n熟悉的角落陌生人看", "model": "music-2.5+", "output_format": "url", "prompt": "独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆" }, "content_type": "application/json" } }, "input": { "conditions": [ "Use a nonstreaming request. MP3 and WAV are available; a PCM control is absent from this method." ], "content_type": "application/json", "material_types": [ "text" ], "optional": [ "stream", "output_format", "audio_setting", "aigc_watermark" ], "required": [ "model", "prompt", "lyrics" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "audio" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/music/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "method": { "http": "POST", "path": "/v1/music/generations" }, "method_aliases": [], "output": { "all_results": "One generated audio; retain every returned field. audio and audio_url are representations of the same output, not separate songs.", "family": "audio", "fields": [ { "name": "data.audio", "type": "string" }, { "name": "data.audio_url", "type": "string" }, { "name": "data.status", "type": "integer" } ], "format": [ "mp3", "wav" ] } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_quantity": "one request" }, "label": "Per request", "units": [ { "amount": "0.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": true, "estimate_only": false, "key": "per_request", "label": "per request", "native_amount_usd_per_unit": "0.3", "native_quantity": 1, "public_unit_label": "per request", "quantity": 1, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "per_request" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=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\"}')\n\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\n# Submit once. Retain the complete result, original identifiers and every response header.\n", "label": "curl · create once and retain the complete result", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "music", "http": "POST", "img_in": null, "img_out": null, "in": null, "input": [ "text" ], "label": "Music", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "audio" ], "path": "/v1/music/generations", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "per_request", "cache_read_price": null, "cache_write_1h_price": null, "cache_write_price": null, "fast_multiplier": null, "flex_multiplier": null, "image_input_price": null, "image_output_price": null, "input_price": null, "intervals": [], "max_reasoning_effort_multiplier": null, "output_price": null, "per_request_price": "0.3" }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_quantity": "one request" }, "label": "Per request", "units": [ { "amount": "0.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": true, "estimate_only": false, "key": "per_request", "label": "per request", "native_amount_usd_per_unit": "0.3", "native_quantity": 1, "public_unit_label": "per request", "quantity": 1, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "per_request" } ] } ], "request_model_id": "music-2.5+", "route_label": "Ultra", "status_reads": [], "tiers": [], "unit": "per_request", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": true, "estimate_only": false, "key": "per_request", "label": "per request", "native_amount_usd_per_unit": "0.3", "native_quantity": 1, "public_unit_label": "per request", "quantity": 1, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "per_request" } ] } } ], "model_id": "minimax/music-2.5+", "nativeProvenance": { "input_facts_canonical_sha256": "859d0f638404bef4f5fb7295c90eb30dc68eddec881bc0bea1e0637febdf25b8", "input_html_sha256": "6e96820bad0e8ca6043c74495e8dce3acbfc15dff7e1386d3200770f0d3f09c3", "private_audit_sha256": "0355dc7febdac420e94b962d23c85fe075f0852300388820f94c2908a80dc69d", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/th/minimax-music-2-5-u002b/", "description": "MiniMax Music 2.5+ สร้างเพลงจาก prompt ที่ระบุแนวเพลงและอารมณ์ พร้อมเนื้อเพลงที่ป้อนให้ โปรไฟล์เพลงแบบซิงโครนัสรับ prompt 10–2,000 อักขระ เนื้อเพลง 10–3,500 อักขระ และเอาต์พุต MP3 หรือ WAV", "locale": "th", "md_url": "https://ailoot.ai/models/th/minimax-music-2-5-u002b/index.md", "title": "MiniMax: Music 2.5+ — Ailoot", "url": "https://ailoot.ai/models/th/minimax-music-2-5-u002b/" }, "rawModel": { "about": "MiniMax Music 2.5+ สร้างเพลงจากบรีฟดนตรีเป็นข้อความและเนื้อเพลง เลือก minimax/music-2.5+ สำหรับรุ่นนี้โดยเฉพาะ โดย music-2.5+ เป็น ชื่อเรียกอีกแบบ ที่กำหนดไว้ เมธอดเพลงใช้คำขอ JSON ที่มี model, prompt และ lyrics แล้วสร้างเสียงผลลัพธ์ ใช้เปลี่ยนแนวคิดเพลงที่เขียนไว้เป็นร่างสำหรับฟัง ใส่ดนตรีให้เนื้อเพลงที่ป้อน หรือสำรวจบทประพันธ์ก่อนแก้ไขต่อ\n\nใช้ prompt อธิบายแนวดนตรี อารมณ์ และบรรยากาศ ส่วน lyrics ใช้สำหรับคำที่จะร้อง บรีฟที่มีประโยชน์อาจขอเพลงโฟล์กที่ครุ่นคิดสำหรับคาเฟ่เงียบ ๆ โดยมีท่อนเวิร์ส ที่ปูฉากและท่อนคอรัส ที่ย้ำแนวคิดหลัก เก็บแนวทางดนตรีไว้ใน prompt และบรรทัดเนื้อร้องที่ต้องการไว้ใน lyrics เพื่อให้ข้อความมีบทบาทในบทเพลงชัดเจน\n\nสำหรับ Music 2.5+ ค่า prompt ต้องมี 10–2,000 อักขระ และ lyrics ต้องมี 10–3,500 อักขระ ใส่ฟิลด์ข้อความทั้งสองในคำขอพร้อมโมเดลที่เลือก ใช้พื้นที่ prompt สำหรับการเลือกทางดนตรีที่สำคัญ แล้วใส่เนื้อร้องที่ต้องการทั้งหมดไว้ใน lyrics บรีฟที่กระชับแต่ครบถ้วนเปรียบเทียบกับเพลงที่ส่งกลับมาได้ง่ายกว่าคำสั่งที่ไม่เกี่ยวข้องกันซึ่งกระจายอยู่ทั้งสองฟิลด์\n\nแบ่งบรรทัดเนื้อเพลงด้วยอักขระขึ้นบรรทัดใหม่ ป้ายชื่อท่อน เช่น [Intro], [Verse], [Pre Chorus], [Chorus], [Bridge] และ [Outro] ใช้ระบุโครงสร้างที่ต้องการได้ ชุดตามเอกสารยังมี [Interlude], [Post Chorus], [Transition], [Break], [Hook], [Build Up], [Inst] และ [Solo] ใส่เนื้อร้องจริงใต้ป้ายชื่อท่อนและกำหนดท่อนซ้ำอย่างตั้งใจ เครื่องหมายเหล่านี้ให้โครงสร้างสำหรับแต่งเพลง โดยควรตรวจทานว่าเพลงที่เสร็จแล้วทำการเปลี่ยนท่อนและการซ้ำจริงอย่างไร\n\nออบเจ็กต์ audio_setting มีค่า sample_rate เป็น 16000, 24000, 32000 หรือ 44100 ค่า bitrate เป็น 32000, 64000, 128000 หรือ 256000 และค่า format เป็น mp3 หรือ wav เลือกการตั้งค่าไฟล์ให้เหมาะกับขั้นตอนตัดต่อหรือเล่นกลับถัดไป และเก็บไว้พร้อมบรีฟ ตัวอย่างที่เผยแพร่ร้องขอ 44100, 256000 และ mp3 ซึ่งเป็นค่าที่เลือกในตัวอย่าง ไม่ใช่ค่าเริ่มต้นสากลสำหรับทั้งสามฟิลด์\n\nกระบวนการเพลงที่เลือกเป็นแบบซิงโครนัสและไม่สตรีม ตัวเลือก output_format ตามเอกสารคือ url และ hex โดย hex เป็นค่าเริ่มต้นในสคีมา ส่วนตัวอย่างที่เลือกร้องขอ url อย่างชัดเจน สำหรับเอาต์พุต URL ให้ใช้ลิงก์ Ailoot ที่ส่งกลับมาเพื่อดาวน์โหลดเสียงที่บันทึกไว้ ผลลัพธ์ hex แทนไบต์เสียงที่ต้องถอดรหัสเป็นรูปแบบไฟล์ที่เลือกก่อนเล่น การตอบกลับอาจมีทั้งตำแหน่ง audio และ audio_url สำหรับเสียงที่สร้างหนึ่งรายการ ให้เก็บผลลัพธ์นั้นเป็นเพลงเดียว\n\nบันทึกเสียงที่เสร็จแล้วพร้อมเนื้อเพลง บรีฟดนตรี ID โมเดลที่ตรงตามชื่อ และการตั้งค่าไฟล์ที่ร้องขอ ฟังเพื่อตรวจเนื้อร้อง ลำดับท่อน และแนวทางดนตรีที่ต้องการก่อนใส่ลงในโครงการ หากคำขอสิ้นสุดโดยไม่ได้ผลลัพธ์ครบถ้วน ให้เก็บข้อมูลระบุตัวตนของคำขอเดิมและข้อมูลการตอบกลับเพื่อตรวจผลลัพธ์ คำขอทดแทนอัตโนมัติอาจสร้างเพลงอีกเพลง การแก้ไขสามารถเปลี่ยนเนื้อร้องหรือคำสั่งดนตรีเฉพาะจุด โดยคงส่วนที่เหลือของบรีฟไว้สำหรับเปรียบเทียบ", "alias_of": null, "aliases": [ "music-2.5+" ], "author": "MiniMax", "ctx": null, "formats": [ "music" ], "id": "minimax/music-2.5+", "input": [ "text" ], "kind": "music", "max_out": null, "methods": [ { "available": null, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response, all actual results, original identifiers, usage and response headers.", "authentication": { "api_key_source": "AILOOT_API_KEY", "header": "Authorization: Bearer" }, "example_body": { "audio_setting": { "bitrate": 256000, "format": "mp3", "sample_rate": 44100 }, "lyrics": "[verse]\n街灯微亮晚风轻抚\n影子拉长独自漫步\n旧外套裹着深深忧郁\n不知去向渴望何处\n[chorus]\n推开木门香气弥漫\n熟悉的角落陌生人看", "model": "minimax/music-2.5+", "output_format": "url", "prompt": "独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆" }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "audio" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/music/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "outputs": { "all_results": "One generated audio; retain every returned field. audio and audio_url are representations of the same output, not separate songs.", "family": "audio", "fields": [ { "name": "data.audio", "type": "string" }, { "name": "data.audio_url", "type": "string" }, { "name": "data.status", "type": "integer" } ], "format": [ "mp3", "wav" ] }, "parameters": [ { "default_known": false, "enum": [ "minimax/music-2.5+" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "default_known": false, "enum_known": false, "maxLength": 2000, "minLength": 10, "name": "prompt", "required": true, "type": "string" }, { "default_known": false, "enum_known": false, "maxLength": 3500, "minLength": 10, "name": "lyrics", "required": true, "type": "string" }, { "default": false, "default_known": true, "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" }, { "default": "hex", "default_known": true, "enum": [ "url", "hex" ], "enum_known": true, "name": "output_format", "required": false, "type": "string" }, { "additionalProperties": false, "default_known": false, "enum_known": false, "name": "audio_setting", "properties": { "bitrate": { "enum": [ 32000, 64000, 128000, 256000 ], "type": "integer" }, "format": { "enum": [ "mp3", "wav" ], "type": "string" }, "sample_rate": { "enum": [ 16000, 24000, 32000, 44100 ], "type": "integer" } }, "required": false, "type": "object" }, { "default_known": false, "enum": [ 16000, 24000, 32000, 44100 ], "enum_known": true, "name": "audio_setting.sample_rate", "required": false, "type": "integer" }, { "default_known": false, "enum": [ 32000, 64000, 128000, 256000 ], "enum_known": true, "name": "audio_setting.bitrate", "required": false, "type": "integer" }, { "default_known": false, "enum": [ "mp3", "wav" ], "enum_known": true, "name": "audio_setting.format", "required": false, "type": "string" }, { "default": false, "default_known": true, "enum_known": false, "name": "aigc_watermark", "required": false, "type": "boolean" } ], "request_schema": { "additionalProperties": false, "properties": { "aigc_watermark": { "default": false, "type": "boolean" }, "audio_setting": { "additionalProperties": false, "properties": { "bitrate": { "enum": [ 32000, 64000, 128000, 256000 ], "type": "integer" }, "format": { "enum": [ "mp3", "wav" ], "type": "string" }, "sample_rate": { "enum": [ 16000, 24000, 32000, 44100 ], "type": "integer" } }, "type": "object" }, "lyrics": { "maxLength": 3500, "minLength": 10, "type": "string" }, "model": { "enum": [ "minimax/music-2.5+" ], "type": "string" }, "output_format": { "default": "hex", "enum": [ "url", "hex" ], "type": "string" }, "prompt": { "maxLength": 2000, "minLength": 10, "type": "string" }, "stream": { "default": false, "enum": [ false ], "type": "boolean" } }, "required": [ "model", "prompt", "lyrics" ], "type": "object" }, "schema_template": { "body": { "audio_setting": { "bitrate": 256000, "format": "mp3", "sample_rate": 44100 }, "lyrics": "[verse]\n街灯微亮晚风轻抚\n影子拉长独自漫步\n旧外套裹着深深忧郁\n不知去向渴望何处\n[chorus]\n推开木门香气弥漫\n熟悉的角落陌生人看", "model": "minimax/music-2.5+", "output_format": "url", "prompt": "独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆" }, "content_type": "application/json" } }, "input": { "conditions": [ "Use a nonstreaming request. MP3 and WAV are available; a PCM control is absent from this method." ], "content_type": "application/json", "material_types": [ "text" ], "optional": [ "stream", "output_format", "audio_setting", "aigc_watermark" ], "required": [ "model", "prompt", "lyrics" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "audio" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/music/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "method": { "http": "POST", "path": "/v1/music/generations" }, "method_aliases": [], "output": { "all_results": "One generated audio; retain every returned field. audio and audio_url are representations of the same output, not separate songs.", "family": "audio", "fields": [ { "name": "data.audio", "type": "string" }, { "name": "data.audio_url", "type": "string" }, { "name": "data.status", "type": "integer" } ], "format": [ "mp3", "wav" ] } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_quantity": "one request" }, "label": "Per request", "units": [ { "amount": "0.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": true, "estimate_only": false, "key": "per_request", "label": "per request", "native_amount_usd_per_unit": "0.3", "native_quantity": 1, "public_unit_label": "per request", "quantity": 1, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "per_request" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=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\"}')\n\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\n# Submit once. Retain the complete result, original identifiers and every response header.\n", "label": "curl · create once and retain the complete result", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "music", "http": "POST", "img_in": null, "img_out": null, "in": null, "input": [ "text" ], "label": "Music", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "audio" ], "path": "/v1/music/generations", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "per_request", "cache_read_price": null, "cache_write_1h_price": null, "cache_write_price": null, "fast_multiplier": null, "flex_multiplier": null, "image_input_price": null, "image_output_price": null, "input_price": null, "intervals": [], "max_reasoning_effort_multiplier": null, "output_price": null, "per_request_price": "0.3" }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_quantity": "one request" }, "label": "Per request", "units": [ { "amount": "0.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": true, "estimate_only": false, "key": "per_request", "label": "per request", "native_amount_usd_per_unit": "0.3", "native_quantity": 1, "public_unit_label": "per request", "quantity": 1, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "per_request" } ] } ], "request_model_id": "minimax/music-2.5+", "route_label": "Ultra", "status_reads": [], "tiers": [], "unit": "per_request", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": true, "estimate_only": false, "key": "per_request", "label": "per request", "native_amount_usd_per_unit": "0.3", "native_quantity": 1, "public_unit_label": "per request", "quantity": 1, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "per_request" } ] }, { "available": null, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response, all actual results, original identifiers, usage and response headers.", "authentication": { "api_key_source": "AILOOT_API_KEY", "header": "Authorization: Bearer" }, "example_body": { "audio_setting": { "bitrate": 256000, "format": "mp3", "sample_rate": 44100 }, "lyrics": "[verse]\n街灯微亮晚风轻抚\n影子拉长独自漫步\n旧外套裹着深深忧郁\n不知去向渴望何处\n[chorus]\n推开木门香气弥漫\n熟悉的角落陌生人看", "model": "music-2.5+", "output_format": "url", "prompt": "独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆" }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "audio" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/music/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "outputs": { "all_results": "One generated audio; retain every returned field. audio and audio_url are representations of the same output, not separate songs.", "family": "audio", "fields": [ { "name": "data.audio", "type": "string" }, { "name": "data.audio_url", "type": "string" }, { "name": "data.status", "type": "integer" } ], "format": [ "mp3", "wav" ] }, "parameters": [ { "default_known": false, "enum": [ "music-2.5+" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "default_known": false, "enum_known": false, "maxLength": 2000, "minLength": 10, "name": "prompt", "required": true, "type": "string" }, { "default_known": false, "enum_known": false, "maxLength": 3500, "minLength": 10, "name": "lyrics", "required": true, "type": "string" }, { "default": false, "default_known": true, "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" }, { "default": "hex", "default_known": true, "enum": [ "url", "hex" ], "enum_known": true, "name": "output_format", "required": false, "type": "string" }, { "additionalProperties": false, "default_known": false, "enum_known": false, "name": "audio_setting", "properties": { "bitrate": { "enum": [ 32000, 64000, 128000, 256000 ], "type": "integer" }, "format": { "enum": [ "mp3", "wav" ], "type": "string" }, "sample_rate": { "enum": [ 16000, 24000, 32000, 44100 ], "type": "integer" } }, "required": false, "type": "object" }, { "default_known": false, "enum": [ 16000, 24000, 32000, 44100 ], "enum_known": true, "name": "audio_setting.sample_rate", "required": false, "type": "integer" }, { "default_known": false, "enum": [ 32000, 64000, 128000, 256000 ], "enum_known": true, "name": "audio_setting.bitrate", "required": false, "type": "integer" }, { "default_known": false, "enum": [ "mp3", "wav" ], "enum_known": true, "name": "audio_setting.format", "required": false, "type": "string" }, { "default": false, "default_known": true, "enum_known": false, "name": "aigc_watermark", "required": false, "type": "boolean" } ], "request_schema": { "additionalProperties": false, "properties": { "aigc_watermark": { "default": false, "type": "boolean" }, "audio_setting": { "additionalProperties": false, "properties": { "bitrate": { "enum": [ 32000, 64000, 128000, 256000 ], "type": "integer" }, "format": { "enum": [ "mp3", "wav" ], "type": "string" }, "sample_rate": { "enum": [ 16000, 24000, 32000, 44100 ], "type": "integer" } }, "type": "object" }, "lyrics": { "maxLength": 3500, "minLength": 10, "type": "string" }, "model": { "enum": [ "music-2.5+" ], "type": "string" }, "output_format": { "default": "hex", "enum": [ "url", "hex" ], "type": "string" }, "prompt": { "maxLength": 2000, "minLength": 10, "type": "string" }, "stream": { "default": false, "enum": [ false ], "type": "boolean" } }, "required": [ "model", "prompt", "lyrics" ], "type": "object" }, "schema_template": { "body": { "audio_setting": { "bitrate": 256000, "format": "mp3", "sample_rate": 44100 }, "lyrics": "[verse]\n街灯微亮晚风轻抚\n影子拉长独自漫步\n旧外套裹着深深忧郁\n不知去向渴望何处\n[chorus]\n推开木门香气弥漫\n熟悉的角落陌生人看", "model": "music-2.5+", "output_format": "url", "prompt": "独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆" }, "content_type": "application/json" } }, "input": { "conditions": [ "Use a nonstreaming request. MP3 and WAV are available; a PCM control is absent from this method." ], "content_type": "application/json", "material_types": [ "text" ], "optional": [ "stream", "output_format", "audio_setting", "aigc_watermark" ], "required": [ "model", "prompt", "lyrics" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "audio" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/music/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "method": { "http": "POST", "path": "/v1/music/generations" }, "method_aliases": [], "output": { "all_results": "One generated audio; retain every returned field. audio and audio_url are representations of the same output, not separate songs.", "family": "audio", "fields": [ { "name": "data.audio", "type": "string" }, { "name": "data.audio_url", "type": "string" }, { "name": "data.status", "type": "integer" } ], "format": [ "mp3", "wav" ] } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_quantity": "one request" }, "label": "Per request", "units": [ { "amount": "0.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": true, "estimate_only": false, "key": "per_request", "label": "per request", "native_amount_usd_per_unit": "0.3", "native_quantity": 1, "public_unit_label": "per request", "quantity": 1, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "per_request" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=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\"}')\n\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\n# Submit once. Retain the complete result, original identifiers and every response header.\n", "label": "curl · create once and retain the complete result", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "music", "http": "POST", "img_in": null, "img_out": null, "in": null, "input": [ "text" ], "label": "Music", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "audio" ], "path": "/v1/music/generations", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "per_request", "cache_read_price": null, "cache_write_1h_price": null, "cache_write_price": null, "fast_multiplier": null, "flex_multiplier": null, "image_input_price": null, "image_output_price": null, "input_price": null, "intervals": [], "max_reasoning_effort_multiplier": null, "output_price": null, "per_request_price": "0.3" }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_quantity": "one request" }, "label": "Per request", "units": [ { "amount": "0.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": true, "estimate_only": false, "key": "per_request", "label": "per request", "native_amount_usd_per_unit": "0.3", "native_quantity": 1, "public_unit_label": "per request", "quantity": 1, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "per_request" } ] } ], "request_model_id": "music-2.5+", "route_label": "Ultra", "status_reads": [], "tiers": [], "unit": "per_request", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": true, "estimate_only": false, "key": "per_request", "label": "per request", "native_amount_usd_per_unit": "0.3", "native_quantity": 1, "public_unit_label": "per request", "quantity": 1, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "per_request" } ] } ], "model_aliases": [ { "canonical_model_id": "minimax/music-2.5+", "request_model_id": "minimax/music-2.5+", "route_label": "Ultra" }, { "canonical_model_id": "minimax/music-2.5+", "request_model_id": "music-2.5+", "route_label": "Ultra" } ], "name": "MiniMax: Music 2.5+", "price": { "in": "0.3", "in_label": "per request", "out": null, "out_label": null, "sort_in": null, "sort_out": null, "varies": false }, "short": "MiniMax Music 2.5+ สร้างเพลงจาก prompt ที่ระบุแนวเพลงและอารมณ์ พร้อมเนื้อเพลงที่ป้อนให้ โปรไฟล์เพลงแบบซิงโครนัสรับ prompt 10–2,000 อักขระ เนื้อเพลง 10–3,500 อักขระ และเอาต์พุต MP3 หรือ WAV" }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 }, { "contract_json_pointer": "/methods/1/rawMethod/contract", "html_json_pointer": "/methods/1/html", "method_ordinal": 1 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod", "/methods/1/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "MiniMax Music 2.5+ สร้างเพลงจาก prompt ที่ระบุแนวเพลงและอารมณ์ พร้อมเนื้อเพลงที่ป้อนให้ โปรไฟล์เพลงแบบซิงโครนัสรับ prompt 10–2,000 อักขระ เนื้อเพลง 10–3,500 อักขระ และเอาต์พุต MP3 หรือ WAV", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "a424b69496d7d4ed7673dca55c93fe74e1017374ca469b582c336efdabfc6340", "renderer_sha256": "890edb706fafafdd4f598bb324acf65fada58918b0911b97eb80e68be2ef65d9" }, "sourceRevision": "f07e14d256579de0c4afe3ca77f879e7ac933b0a94d06085d7853260453c662b" }