커버 전처리

참조 오디오에서 커버 특징, 가사 및 노래 구조를 추출합니다.

참조 오디오 URL 또는 전체 Base64 내용으로 커버 특징을 추출합니다. 응답의 cover_feature_id는 24시간 동안 유효하며 가사와 함께 음악 생성 인터페이스에 전달하여 커버 결과를 생성할 수 있습니다.

참조 오디오 길이는 6초부터 6분까지이며 크기는 50 MB를 초과하면 안 됩니다. audio_url과 audio_base64 중 정확히 하나만 제공해야 합니다.

POST/v1/music_cover_preprocess

참조 오디오에서 커버 특징, 가사 및 노래 구조를 추출합니다. 동일한 오디오는 동일한 cover_feature_id를 반환하며 이 ID의 유효 기간은 24시간입니다.

audio_url과 audio_base64 중 정확히 하나만 제공해야 합니다. 참조 오디오 길이는 6초부터 6분까지이며 크기는 50 MB를 초과하면 안 됩니다.

전처리 요청에는 minimax_music_cover_preprocess를 사용합니다. 특징 ID를 받은 뒤 music-cover로 커버 결과를 생성합니다.

인증

bearerAuth

인증Bearer <token>

Authorization Header에 Bearer your-api-key를 사용합니다.

전달 위치: header

요청 본문

application/json

참조 오디오 및 고정된 커버 모델 식별자입니다.

TypeScript 타입 정의

TypeScript에서 request body 타입을 사용하세요.

audio_url과 audio_base64 중 정확히 하나만 제공해야 합니다.

model*string

커버 전처리 모델 ID이며 현재 검증된 값은 minimax_music_cover_preprocess입니다. 전처리 완료 후 music-cover로 커버 결과를 생성합니다.

audio_url?string

공개 인터넷에서 직접 다운로드할 수 있는 참조 오디오 URL입니다.

형식uri

audio_base64?string

Data URL 접두사가 없는 전체 오디오 Base64입니다.

응답 본문

`application/json`

curl -X POST "https://example.com/v1/music_cover_preprocess" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax_music_cover_preprocess",
    "audio_url": "https://example.com/song-with-vocals.mp3"
  }'

{
  "cover_feature_id": "c81575b998100567b8d08eb1e9facf09",
  "formatted_lyrics": "[Verse]\nAmazing grace\nHow sweet the sound",
  "audio_duration": 15.283628117913832,
  "trace_id": "06d73273f48b188cf612905231003a28",
  "structure_result": "{\"num_segments\":1,\"segments\":[{\"start\":0,\"end\":15.241,\"label\":\"verse\"}]}",
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

인증

요청 본문

응답 본문

200application/json

401application/json

`application/json`

`application/json`