MiniMax: Music 2.5
MiniMax Music 2.5는 동기식 음악 요청을 통해 가사와 음악 작업 지시로 오디오를 생성합니다. 이 정확한 버전은 비어 있는 prompt를 허용하며, lyrics 1–3,500자와 MP3 또는 WAV 출력을 지원합니다.
- Ailoot Ultra · Music
POST /v1/music/generationsminimax/music-2.5 - Ailoot Ultra · Music
POST /v1/music/generationsmusic-2.5
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
MiniMax Music 2.5는 텍스트로 작성한 음악 작업 지시와 가사로 음악을 만듭니다. 이 정확한 버전에는 minimax/music-2.5를 선택하세요. 설정된 별칭은 music-2.5입니다. 음악 메서드는 model, prompt, lyrics가 포함된 JSON 요청을 사용하고 생성된 오디오를 출력합니다. 글로 정리한 노래 콘셉트를 감상용 초안으로 만들거나, 제공된 가사에 곡을 붙이거나, 추가 편집 전에 작곡 방향을 살펴보는 데 사용하세요.
prompt에는 음악 스타일, 분위기, 배경을 설명하고 lyrics에는 부를 가사를 넣으세요. 예를 들어 조용한 카페를 위한 내면을 성찰하는 포크송을 요청하면서 절에서는 장면을 설정하고 후렴에서는 핵심 생각을 반복하도록 할 수 있습니다. 음악적 방향은 prompt에, 의도한 가사 행은 lyrics에 넣어 텍스트가 곡 안에서 명확한 역할을 갖게 하세요.
이 버전은 prompt 0~2,000자와 lyrics 1~3,500자를 허용합니다. 스키마가 여전히 prompt를 필수 필드로 나열하므로, 구성된 요청에는 값이 비어 있어도 prompt 필드가 포함됩니다. 방향을 지정한 작곡에서는 그 필드에 장르, 감정, 배경을 명시하세요. 값을 비워 두면 이러한 텍스트 지시는 지정되지 않습니다. 전체 가사 텍스트는 자체 한도 안에 유지하세요.
가사 행은 줄바꿈 문자로 구분하세요. [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 Ultra · Music POST /v1/music/generations minimax/music-2.5
minimax/music-2.5minimax/music-2.5music-2.5
시작하기
MiniMax Music 2.5는 동기식 음악 요청을 통해 가사와 음악 작업 지시로 오디오를 생성합니다. 이 정확한 버전은 비어 있는 prompt를 허용하며, lyrics 1–3,500자와 MP3 또는 WAV 출력을 지원합니다.
- 허용 입력
- 텍스트
- 결과
- 오디오
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot Ultra · Music POST /v1/music/generations
- 입력
text- 출력
audio- 출력 형식
- mp3,wav
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 minimax/music-2.5 | 기본값— |
필드prompt | 유형string | 요건필수 | 값과 한도 | 기본값— |
필드lyrics | 유형string | 요건필수 | 값과 한도 | 기본값— |
필드stream | 유형boolean | 요건선택 사항 | 값과 한도 false | 기본값false |
필드output_format | 유형string | 요건선택 사항 | 값과 한도 url, hex | 기본값hex |
필드audio_setting | 유형object | 요건선택 사항 | 값과 한도 | 기본값— |
필드audio_setting.sample_rate | 유형integer | 요건선택 사항 | 값과 한도 16,000, 24,000, 32,000, 44,100 | 기본값— |
필드audio_setting.bitrate | 유형integer | 요건선택 사항 | 값과 한도 32,000, 64,000, 128,000, 256,000 | 기본값— |
필드audio_setting.format | 유형string | 요건선택 사항 | 값과 한도 mp3, wav | 기본값— |
필드aigc_watermark | 유형boolean | 요건선택 사항 | 값과 한도 | 기본값false |
메서드 매개변수와 수명 주기
| 매개변수 | 명세 |
|---|---|
매개변수content_type | 명세application/json |
매개변수required | 명세model, prompt, lyrics |
매개변수optional | 명세stream, output_format, audio_setting, aigc_watermark |
매개변수material_types | 명세text |
매개변수conditions | 명세Use a nonstreaming request. MP3 and WAV are available; a PCM control is absent from this method. |
수명 주기: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
요금
요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.
- 빠른 모드
- 미지정 빠른 모드를 선택한 경우
- Flex 모드
- 미지정 flex 모드를 선택한 경우
- 최대 추론 수준
- 미지정 최대 추론 수준에 default 조정값을 적용하는 경우
Ailoot 요금
설정별 가격
각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.
| 설정 | 요금표 | 과금 수량 | 요금 |
|---|---|---|---|
| 설정기본 토큰 요금 | 요금표기본 요금 | 과금 수량— | 요금 입력 · 입력 토큰 — / 1K 토큰 출력 · 출력 토큰 — / 1K 토큰 입력 · 캐시 읽기 — / 1K 토큰 입력 · 캐시 쓰기 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 — / 1K 토큰 |
| 설정요청당 | 요금표— | 과금 수량요청 1회 | 요금 입력 $0.3 요청당 |
Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →
요청 예제
Ailoot Ultra · Music
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "minimax/music-2.5", "prompt": "独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆", "lyrics": "[verse]\\n街灯微亮晚风轻抚\\n影子拉长独自漫步\\n旧外套裹着深深忧郁\\n不知去向渴望何处\\n[chorus]\\n推开木门香气弥漫\\n熟悉的角落陌生人看", "audio_setting": {"sample_rate": 44100, "bitrate": 256000, "format": "mp3"}, "output_format": "url"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
결과 수신 및 저장
Ailoot Ultra · Music
mp3,wav
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
완료된 결과 모두 보관
반환된 완전한 응답, 파일, 콘텐츠 부분을 모두 보관하세요.
One generated audio; retain every returned field. audio and audio_url are representations of the same output, not separate songs.
원래 응답을 확인해야 할 경우
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
응답 필드
| 필드 | 유형 |
|---|---|
필드data.audio | 유형string |
필드data.audio_url | 유형string |
필드data.status | 유형integer |
별칭
모델 별칭
Ailoot Ultra minimax/music-2.5, music-2.5
메서드 경로 별칭
위에 표시된 메서드 경로를 사용하세요.
관련 호출용 ID
Ailoot Ultra · Music POST /v1/music/generations music-2.5
music-2.5minimax/music-2.5music-2.5
시작하기
MiniMax Music 2.5는 동기식 음악 요청을 통해 가사와 음악 작업 지시로 오디오를 생성합니다. 이 정확한 버전은 비어 있는 prompt를 허용하며, lyrics 1–3,500자와 MP3 또는 WAV 출력을 지원합니다.
- 허용 입력
- 텍스트
- 결과
- 오디오
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot Ultra · Music POST /v1/music/generations
- 입력
text- 출력
audio- 출력 형식
- mp3,wav
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 music-2.5 | 기본값— |
필드prompt | 유형string | 요건필수 | 값과 한도 | 기본값— |
필드lyrics | 유형string | 요건필수 | 값과 한도 | 기본값— |
필드stream | 유형boolean | 요건선택 사항 | 값과 한도 false | 기본값false |
필드output_format | 유형string | 요건선택 사항 | 값과 한도 url, hex | 기본값hex |
필드audio_setting | 유형object | 요건선택 사항 | 값과 한도 | 기본값— |
필드audio_setting.sample_rate | 유형integer | 요건선택 사항 | 값과 한도 16,000, 24,000, 32,000, 44,100 | 기본값— |
필드audio_setting.bitrate | 유형integer | 요건선택 사항 | 값과 한도 32,000, 64,000, 128,000, 256,000 | 기본값— |
필드audio_setting.format | 유형string | 요건선택 사항 | 값과 한도 mp3, wav | 기본값— |
필드aigc_watermark | 유형boolean | 요건선택 사항 | 값과 한도 | 기본값false |
메서드 매개변수와 수명 주기
| 매개변수 | 명세 |
|---|---|
매개변수content_type | 명세application/json |
매개변수required | 명세model, prompt, lyrics |
매개변수optional | 명세stream, output_format, audio_setting, aigc_watermark |
매개변수material_types | 명세text |
매개변수conditions | 명세Use a nonstreaming request. MP3 and WAV are available; a PCM control is absent from this method. |
수명 주기: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
요금
요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.
- 빠른 모드
- 미지정 빠른 모드를 선택한 경우
- Flex 모드
- 미지정 flex 모드를 선택한 경우
- 최대 추론 수준
- 미지정 최대 추론 수준에 default 조정값을 적용하는 경우
Ailoot 요금
설정별 가격
각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.
| 설정 | 요금표 | 과금 수량 | 요금 |
|---|---|---|---|
| 설정기본 토큰 요금 | 요금표기본 요금 | 과금 수량— | 요금 입력 · 입력 토큰 — / 1K 토큰 출력 · 출력 토큰 — / 1K 토큰 입력 · 캐시 읽기 — / 1K 토큰 입력 · 캐시 쓰기 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 — / 1K 토큰 |
| 설정요청당 | 요금표— | 과금 수량요청 1회 | 요금 입력 $0.3 요청당 |
Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →
요청 예제
Ailoot Ultra · Music
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "music-2.5", "prompt": "独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆", "lyrics": "[verse]\\n街灯微亮晚风轻抚\\n影子拉长独自漫步\\n旧外套裹着深深忧郁\\n不知去向渴望何处\\n[chorus]\\n推开木门香气弥漫\\n熟悉的角落陌生人看", "audio_setting": {"sample_rate": 44100, "bitrate": 256000, "format": "mp3"}, "output_format": "url"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
결과 수신 및 저장
Ailoot Ultra · Music
mp3,wav
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
완료된 결과 모두 보관
반환된 완전한 응답, 파일, 콘텐츠 부분을 모두 보관하세요.
One generated audio; retain every returned field. audio and audio_url are representations of the same output, not separate songs.
원래 응답을 확인해야 할 경우
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
응답 필드
| 필드 | 유형 |
|---|---|
필드data.audio | 유형string |
필드data.audio_url | 유형string |
필드data.status | 유형integer |
별칭
모델 별칭
Ailoot Ultra minimax/music-2.5, music-2.5
메서드 경로 별칭
위에 표시된 메서드 경로를 사용하세요.
관련 호출용 ID
FAQ · MiniMax: Music 2.5
- 어떤 입력과 결과를 사용할 수 있나요?
POST /v1/music/generations·minimax/music-2.5:text→audioPOST /v1/music/generations·music-2.5:text→audio- 요청은 어떤 필드를 사용하나요?
POST /v1/music/generations·minimax/music-2.5:model,prompt,lyrics,stream,output_format,audio_setting,aigc_watermarkPOST /v1/music/generations·music-2.5:model,prompt,lyrics,stream,output_format,audio_setting,aigc_watermark