MiniMax: Music 2.5
MiniMax Music 2.5 chuyển lời bài hát và bản mô tả âm nhạc thành âm thanh qua yêu cầu âm nhạc đồng bộ. Đúng phiên bản này cho phép prompt rỗng, nhận lyrics dài 1–3.500 ký tự và cung cấp đầu ra MP3 hoặc WAV.
- Ailoot Ultra · Music
POST /v1/music/generationsminimax/music-2.5 - Ailoot Ultra · Music
POST /v1/music/generationsmusic-2.5
Về mô hình
Mô tả này trình bày khả năng của mô hình. Đầu vào, đầu ra và tùy chọn có trên Ailoot được liệt kê bên dưới cho phương thức đã chọn.
MiniMax Music 2.5 tạo nhạc từ bản mô tả âm nhạc bằng văn bản và lời bài hát. Chọn minimax/music-2.5 để dùng đúng phiên bản này; music-2.5 là bí danh được cấu hình. Phương thức âm nhạc của mô hình dùng yêu cầu JSON với model, prompt và lyrics rồi tạo âm thanh. Dùng để biến ý tưởng bài hát bằng văn bản thành bản nghe thử, phổ nhạc cho lời được cung cấp hoặc khám phá tác phẩm trước khi chỉnh sửa tiếp.
Dùng prompt để mô tả phong cách âm nhạc, tâm trạng và bối cảnh, còn lyrics chứa những lời cần hát. Một bản mô tả hữu ích có thể yêu cầu bài dân ca mang tính chiêm nghiệm cho quán cà phê yên tĩnh, với một khổ hát dựng bối cảnh và điệp khúc lặp lại ý chính. Giữ định hướng âm nhạc trong prompt và các câu dự định trong lyrics để văn bản có vai trò rõ ràng trong tác phẩm.
Phiên bản này cho phép prompt từ 0 đến 2.000 ký tự và lyrics từ 1 đến 3.500 ký tự. Yêu cầu theo cấu hình bao gồm trường prompt ngay cả khi giá trị rỗng, vì lược đồ vẫn liệt kê prompt trong các trường bắt buộc. Với tác phẩm có định hướng, dùng trường đó để nêu thể loại, cảm xúc và bối cảnh; khi giá trị rỗng, những chỉ dẫn bằng văn bản đó chưa được xác định. Giữ toàn bộ lời bài hát trong giới hạn riêng của nó.
Tách các câu hát bằng ký tự xuống dòng. Các nhãn phần như [Intro], [Verse], [Pre Chorus], [Chorus], [Bridge] và [Outro] có thể xác định cấu trúc dự định; tập hợp được ghi trong tài liệu cũng gồm [Interlude], [Post Chorus], [Transition], [Break], [Hook], [Build Up], [Inst] và [Solo]. Đặt lời thực tế bên dưới nhãn phần tương ứng và chủ động xác định các phần lặp lại. Các dấu này cung cấp cấu trúc cho tác phẩm; hãy đánh giá cách bài hát hoàn tất thực sự thể hiện các chuyển đoạn và lặp lại.
Đối tượng audio_setting cung cấp các giá trị sample_rate là 16000, 24000, 32000 hoặc 44100, các giá trị bitrate là 32000, 64000, 128000 hoặc 256000 và các giá trị format là mp3 hoặc wav. Chọn thiết lập tệp cho bước chỉnh sửa hoặc phát lại tiếp theo và lưu cùng bản mô tả. Ví dụ đã công bố yêu cầu 44100, 256000 và mp3; đây là những lựa chọn trong ví dụ, không phải mặc định chung cho cả ba trường.
Quy trình âm nhạc được chọn là đồng bộ và không truyền luồng. Các lựa chọn output_format được ghi trong tài liệu là url và hex, với hex là mặc định của lược đồ; ví dụ được chọn yêu cầu tường minh url. Với đầu ra URL, dùng liên kết Ailoot được trả về để tải âm thanh đã lưu. Kết quả hex biểu diễn các byte âm thanh cần được giải mã thành định dạng tệp đã chọn trước khi phát lại. Phản hồi có thể chứa cả vị trí audio và audio_url cho một âm thanh được tạo; hãy giữ kết quả đó như một bài hát.
Lưu âm thanh hoàn tất cùng lời bài hát, bản mô tả âm nhạc, ID mô hình chính xác và thiết lập tệp được yêu cầu. Nghe để kiểm tra những lời dự định, thứ tự các phần và định hướng âm nhạc trước khi đưa vào dự án. Nếu yêu cầu kết thúc mà chưa có kết quả đầy đủ, giữ thông tin định danh yêu cầu ban đầu và thông tin phản hồi để kiểm tra kết quả; yêu cầu thay thế tự động có thể tạo một bài hát khác. Một lần chỉnh sửa có thể thay đổi lời hát hoặc chỉ dẫn âm nhạc cụ thể trong khi giữ phần còn lại của bản mô tả để so sánh.
Ailoot Ultra · Music POST /v1/music/generations minimax/music-2.5
minimax/music-2.5minimax/music-2.5music-2.5
Bắt đầu
MiniMax Music 2.5 chuyển lời bài hát và bản mô tả âm nhạc thành âm thanh qua yêu cầu âm nhạc đồng bộ. Đúng phiên bản này cho phép prompt rỗng, nhận lyrics dài 1–3.500 ký tự và cung cấp đầu ra MP3 hoặc WAV.
- Đầu vào được chấp nhận
- Văn bản
- Kết quả
- Âm thanh
Có trên Ailoot · đầu vào & phương thức
Ailoot Ultra · Music POST /v1/music/generations
- Đầu vào
text- Đầu ra
audio- Định dạng đầu ra
- mp3,wav
| Trường | Loại | Yêu cầu | Giá trị & giới hạn | Mặc định |
|---|---|---|---|---|
Trườngmodel | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn minimax/music-2.5 | Mặc định— |
Trườngprompt | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn | Mặc định— |
Trườnglyrics | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngstream | Loạiboolean | Yêu cầuKhông bắt buộc | Giá trị & giới hạn false | Mặc địnhfalse |
Trườngoutput_format | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn url, hex | Mặc địnhhex |
Trườngaudio_setting | Loạiobject | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngaudio_setting.sample_rate | Loạiinteger | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 16.000, 24.000, 32.000, 44.100 | Mặc định— |
Trườngaudio_setting.bitrate | Loạiinteger | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 32.000, 64.000, 128.000, 256.000 | Mặc định— |
Trườngaudio_setting.format | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn mp3, wav | Mặc định— |
Trườngaigc_watermark | Loạiboolean | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc địnhfalse |
Tham số phương thức và vòng đời
| Tham số | Hợp đồng |
|---|---|
Tham sốcontent_type | Hợp đồngapplication/json |
Tham sốrequired | Hợp đồngmodel, prompt, lyrics |
Tham sốoptional | Hợp đồngstream, output_format, audio_setting, aigc_watermark |
Tham sốmaterial_types | Hợp đồngtext |
Tham sốconditions | Hợp đồngUse a nonstreaming request. MP3 and WAV are available; a PCM control is absent from this method. |
Vòng đời: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Bảng giá
Thông tin biểu giá không bổ sung tùy chọn yêu cầu. Các tham số được hỗ trợ nằm trong phương thức đã chọn.
- Chế độ nhanh
- Chưa chỉ định Khi chọn chế độ nhanh
- Chế độ Flex
- Chưa chỉ định Khi chọn chế độ flex
- Mức độ suy luận tối đa
- Chưa chỉ định Khi áp dụng mức điều chỉnh mặc định (default) cho mức độ suy luận tối đa
Mức phí Ailoot
Giá theo cấu hình
Đối chiếu từng khoản phí với điều kiện hiển thị. Dùng một mức phí cho mỗi nhóm cấu hình thay thế.
| Cấu hình | Biểu mức phí | Lượng dùng để tính phí | Phí |
|---|---|---|---|
| Cấu hìnhGiá cơ sở cho token | Biểu mức phíMức phí cơ bản | Lượng dùng để tính phí— | Phí Đầu vào · Token đầu vào — / 1K token Đầu ra · Token đầu ra — / 1K token Đầu vào · Đọc bộ nhớ đệm — / 1K token Đầu vào · Ghi bộ nhớ đệm — / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ — / 1K token |
| Cấu hìnhMỗi yêu cầu | Biểu mức phí— | Lượng dùng để tính phímột yêu cầu | Phí Đầu vào $0.3 mỗi yêu cầu |
Ailoot tạm giữ một khoản ước tính trước yêu cầu. Sau khi có kết quả, phí cuối cùng được quyết toán theo mức sử dụng đo được. Việc quyết toán khi truyền luồng dùng bản ghi mức sử dụng cuối cùng. Cách hoạt động của cơ chế tạm giữ và quyết toán →
Ví dụ yêu cầu
Ailoot Ultra · Music
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "minimax/music-2.5", "prompt": "独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆", "lyrics": "[verse]\\n街灯微亮晚风轻抚\\n影子拉长独自漫步\\n旧外套裹着深深忧郁\\n不知去向渴望何处\\n[chorus]\\n推开木门香气弥漫\\n熟悉的角落陌生人看", "audio_setting": {"sample_rate": 44100, "bitrate": 256000, "format": "mp3"}, "output_format": "url"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Nhận và lưu kết quả
Ailoot Ultra · Music
mp3,wav
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Lưu tất cả kết quả đã hoàn tất
Lưu mọi phản hồi hoàn chỉnh, tệp và phần nội dung được trả về.
One generated audio; retain every returned field. audio and audio_url are representations of the same output, not separate songs.
Nếu cần kiểm tra phản hồi gốc
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Trường phản hồi
| Trường | Loại |
|---|---|
Trườngdata.audio | Loạistring |
Trườngdata.audio_url | Loạistring |
Trườngdata.status | Loạiinteger |
Bí danh
Bí danh mô hình
Ailoot Ultra minimax/music-2.5, music-2.5
Bí danh đường dẫn phương thức
Dùng các đường dẫn phương thức hiển thị ở trên.
ID gọi liên quan
Ailoot Ultra · Music POST /v1/music/generations music-2.5
music-2.5minimax/music-2.5music-2.5
Bắt đầu
MiniMax Music 2.5 chuyển lời bài hát và bản mô tả âm nhạc thành âm thanh qua yêu cầu âm nhạc đồng bộ. Đúng phiên bản này cho phép prompt rỗng, nhận lyrics dài 1–3.500 ký tự và cung cấp đầu ra MP3 hoặc WAV.
- Đầu vào được chấp nhận
- Văn bản
- Kết quả
- Âm thanh
Có trên Ailoot · đầu vào & phương thức
Ailoot Ultra · Music POST /v1/music/generations
- Đầu vào
text- Đầu ra
audio- Định dạng đầu ra
- mp3,wav
| Trường | Loại | Yêu cầu | Giá trị & giới hạn | Mặc định |
|---|---|---|---|---|
Trườngmodel | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn music-2.5 | Mặc định— |
Trườngprompt | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn | Mặc định— |
Trườnglyrics | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngstream | Loạiboolean | Yêu cầuKhông bắt buộc | Giá trị & giới hạn false | Mặc địnhfalse |
Trườngoutput_format | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn url, hex | Mặc địnhhex |
Trườngaudio_setting | Loạiobject | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngaudio_setting.sample_rate | Loạiinteger | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 16.000, 24.000, 32.000, 44.100 | Mặc định— |
Trườngaudio_setting.bitrate | Loạiinteger | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 32.000, 64.000, 128.000, 256.000 | Mặc định— |
Trườngaudio_setting.format | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn mp3, wav | Mặc định— |
Trườngaigc_watermark | Loạiboolean | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc địnhfalse |
Tham số phương thức và vòng đời
| Tham số | Hợp đồng |
|---|---|
Tham sốcontent_type | Hợp đồngapplication/json |
Tham sốrequired | Hợp đồngmodel, prompt, lyrics |
Tham sốoptional | Hợp đồngstream, output_format, audio_setting, aigc_watermark |
Tham sốmaterial_types | Hợp đồngtext |
Tham sốconditions | Hợp đồngUse a nonstreaming request. MP3 and WAV are available; a PCM control is absent from this method. |
Vòng đời: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Bảng giá
Thông tin biểu giá không bổ sung tùy chọn yêu cầu. Các tham số được hỗ trợ nằm trong phương thức đã chọn.
- Chế độ nhanh
- Chưa chỉ định Khi chọn chế độ nhanh
- Chế độ Flex
- Chưa chỉ định Khi chọn chế độ flex
- Mức độ suy luận tối đa
- Chưa chỉ định Khi áp dụng mức điều chỉnh mặc định (default) cho mức độ suy luận tối đa
Mức phí Ailoot
Giá theo cấu hình
Đối chiếu từng khoản phí với điều kiện hiển thị. Dùng một mức phí cho mỗi nhóm cấu hình thay thế.
| Cấu hình | Biểu mức phí | Lượng dùng để tính phí | Phí |
|---|---|---|---|
| Cấu hìnhGiá cơ sở cho token | Biểu mức phíMức phí cơ bản | Lượng dùng để tính phí— | Phí Đầu vào · Token đầu vào — / 1K token Đầu ra · Token đầu ra — / 1K token Đầu vào · Đọc bộ nhớ đệm — / 1K token Đầu vào · Ghi bộ nhớ đệm — / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ — / 1K token |
| Cấu hìnhMỗi yêu cầu | Biểu mức phí— | Lượng dùng để tính phímột yêu cầu | Phí Đầu vào $0.3 mỗi yêu cầu |
Ailoot tạm giữ một khoản ước tính trước yêu cầu. Sau khi có kết quả, phí cuối cùng được quyết toán theo mức sử dụng đo được. Việc quyết toán khi truyền luồng dùng bản ghi mức sử dụng cuối cùng. Cách hoạt động của cơ chế tạm giữ và quyết toán →
Ví dụ yêu cầu
Ailoot Ultra · Music
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "music-2.5", "prompt": "独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆", "lyrics": "[verse]\\n街灯微亮晚风轻抚\\n影子拉长独自漫步\\n旧外套裹着深深忧郁\\n不知去向渴望何处\\n[chorus]\\n推开木门香气弥漫\\n熟悉的角落陌生人看", "audio_setting": {"sample_rate": 44100, "bitrate": 256000, "format": "mp3"}, "output_format": "url"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Nhận và lưu kết quả
Ailoot Ultra · Music
mp3,wav
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Lưu tất cả kết quả đã hoàn tất
Lưu mọi phản hồi hoàn chỉnh, tệp và phần nội dung được trả về.
One generated audio; retain every returned field. audio and audio_url are representations of the same output, not separate songs.
Nếu cần kiểm tra phản hồi gốc
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Trường phản hồi
| Trường | Loại |
|---|---|
Trườngdata.audio | Loạistring |
Trườngdata.audio_url | Loạistring |
Trườngdata.status | Loạiinteger |
Bí danh
Bí danh mô hình
Ailoot Ultra minimax/music-2.5, music-2.5
Bí danh đường dẫn phương thức
Dùng các đường dẫn phương thức hiển thị ở trên.
ID gọi liên quan
FAQ · MiniMax: Music 2.5
- Có những đầu vào và kết quả nào?
POST /v1/music/generations·minimax/music-2.5:text→audioPOST /v1/music/generations·music-2.5:text→audio- Yêu cầu sử dụng những trường nào?
POST /v1/music/generations·minimax/music-2.5:model,prompt,lyrics,stream,output_format,audio_setting,aigc_watermarkPOST /v1/music/generations·music-2.5:model,prompt,lyrics,stream,output_format,audio_setting,aigc_watermark