콘텐츠로 건너뛰기

MiniMax Music 3

통합

모델 id minimax/music-3
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/minimax/music-3?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Warm indie folk, acoustic guitar and soft brushed drums, gentle female vocal, 92 BPM, nostalgic summer evening",
    "lyrics": "[verse]\nPorch lights humming on the edge of town\nWe count the fireflies as the sun goes down\n[chorus]\nStay a little longer, the night is young\nSing me the song that we never sung",
    "duration": 30
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

이 요청: $0.06 60 API 크레딧 이 페이지에서 실행

API 키 받기
MiniMax 텍스트를 음악으로 1–300 s #music#vocals#songs

가사와 스타일 설명으로 보컬이 포함된 최대 5분 길이의 완성곡을 생성합니다.

예시

출력 · ~84 s

프롬프트Warm indie folk, acoustic guitar and soft brushed drums, gentle female vocal, 92 BPM, nostalgic summer evening

30 s$0.06 · 60 API 크레딧

요청 만들기

컨트롤은 모델 스키마에서 생성됩니다. 값을 변경하면 코드와 가격이 업데이트됩니다.

•필수

정밀한 제어를 위해 Structured Caption을 사용할 수 있는 음악 생성 프롬프트입니다. 섹션별 편곡 및 보컬 세부 정보와 장르, BPM, 키, 감정 진행을 지정하는 전역 메타데이터를 결합합니다. 일반 설명에는 원하는 스타일과 분위기, 보컬과 악기 사용 방식, 편곡을 포함합니다.

•필수

부를 가사입니다. 앞에 구조 태그가 있는 줄에 함께 작성된 단어는 모델 입력 계약에 따라 삭제됩니다. [intro], [verse], [pre-chorus], [chorus], [post-chorus], [bridge], [instrumental], [solo], [outro]를 포함한 각 태그를 별도 줄에 작성하세요.

출력 길이를 보장하지 않는 오디오 길이 제한이며, 초 단위로 측정됩니다. 응답에는 실제 길이가 보고되며, 생성이 일찍 중단되면 더 짧을 수 있습니다.

고급 num_inference_steps · guidance_scale · seed
기본값 30

각 8초 디노이징 청크의 플로 매칭을 위한 Euler 단계 수입니다.

기본값 1.7

플로 매칭 중 분류기 없는 가이던스 강도입니다.

재현 가능한 생성을 위한 시드입니다. 값을 제공하지 않으면 무작위로 선택됩니다.

POST /run/minimax/music-3?wait=20 견적 → $0.06
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/minimax/music-3?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Warm indie folk, acoustic guitar and soft brushed drums, gentle female vocal, 92 BPM, nostalgic summer evening",
    "lyrics": "[verse]\nPorch lights humming on the edge of town\nWe count the fireflies as the sun goes down\n[chorus]\nStay a little longer, the night is young\nSing me the song that we never sung",
    "duration": 30
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

이 요청 실행

키는 이 브라우저에 유지됩니다. Doitong API로만 전송되며, 기억하기를 선택한 경우에만 localStorage에 저장됩니다. API 키 받기

MiniMax Music 3 정보

MiniMax Music 3는 완성된 편곡에 가사를 얹어 노래합니다. 프롬프트에 장르, 템포, 조성, 분위기, 보컬 및 악기를 설명하고, [verse], [chorus], [bridge] 같은 태그를 사용해 가사에 곡 구조를 표시하세요. 각 태그는 자체 줄에 작성해야 합니다. 지속 시간(1~300초, 기본값 60)은 상한이며 곡이 더 일찍 끝날 수 있습니다.

매개변수

이름유형 기본값허용됨 설명
prompt필수
유형string
정밀한 제어를 위해 Structured Caption을 사용할 수 있는 음악 생성 프롬프트입니다. 섹션별 편곡 및 보컬 세부 정보와 장르, BPM, 키, 감정 진행을 지정하는 전역 메타데이터를 결합합니다. 일반 설명에는 원하는 스타일과 분위기, 보컬과 악기 사용 방식, 편곡을 포함합니다.
lyrics필수
유형string
부를 가사입니다. 앞에 구조 태그가 있는 줄에 함께 작성된 단어는 모델 입력 계약에 따라 삭제됩니다. [intro], [verse], [pre-chorus], [chorus], [post-chorus], [bridge], [instrumental], [solo], [outro]를 포함한 각 태그를 별도 줄에 작성하세요.
duration선택 사항
유형number
기본값60
1 – 300
출력 길이를 보장하지 않는 오디오 길이 제한이며, 초 단위로 측정됩니다. 응답에는 실제 길이가 보고되며, 생성이 일찍 중단되면 더 짧을 수 있습니다.
seed선택 사항
유형integer | null
재현 가능한 생성을 위한 시드입니다. 값을 제공하지 않으면 무작위로 선택됩니다.
num_inference_steps선택 사항
유형integer
기본값30
1 – 100
각 8초 디노이징 청크의 플로 매칭을 위한 Euler 단계 수입니다.
guidance_scale선택 사항
유형number
기본값1.7
0 – 20
플로 매칭 중 분류기 없는 가이던스 강도입니다.
필수

출력

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "minimax/music-3",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 60,
    "usd": "0.06",
    "charged": 60,
    "refunded": 0
  },
  "input": {
    "prompt": "Genre: acoustic pop. BPM: 96. Key: C major. Warm and intimate, soft female vocal, guitar and light piano",
    "lyrics": "[verse]\nMorning light filtering through the pine\nEvery quiet street is yours and mine\n[chorus]\nSoftly the world begins to breathe",
    "duration": 30
  },
  "output": {
    "audio": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp3",
      "content_type": "audio/mpeg",
      "file_name": "0-output.mp3",
      "file_size": 1843200
    },
    "seed": 42,
    "duration": 5
  },
  "outputs": [
    {
      "type": "audio",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp3",
      "content_type": "audio/mpeg",
      "file_size": 1843200,
      "duration": 12,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
파일 보관 방식 선택모든 outputs[].url은 스토리지에 저장된 복사본입니다. 계정 설정 또는 ?storage=에 따라 영구 보관(GB-월 단위 과금)하거나 7일 동안 무료로 보관합니다.
모든 모델에서 동일한 구조이미지, 동영상, 오디오 모두 type, url, content_type, width, height 및 duration을 사용합니다. output은 모델 자체의 결과 객체입니다.
출력 필드
audio
object {url, content_type, file_name, file_size}44.1 kHz 및 16비트 샘플을 사용하는 스테레오 WAV 형식의 출력 오디오 파일입니다.
seed
integer생성에 사용된 무작위 시드입니다.
duration
number실제로 생성된 오디오의 초 수를 보고합니다. 요청한 길이와 반드시 같지는 않습니다.

더 많은 모델: 텍스트를 음악으로

AI 에이전트용: 이 페이지의 Markdown 버전: https://doitong.com/ko/developers/models/minimax/music-3.md. 모든 모델 및 가이드: https://doitong.com/developers/llms.txt