Tạo âm nhạc và bản cover

Sử dụng giao thức âm nhạc MiniMax để tạo âm nhạc hoặc bản cover đồng bộ.

API này tạo âm nhạc hoặc bản cover trong cùng một yêu cầu HTTP đồng bộ. Yêu cầu thông thường có thể trả về URL âm thanh tạm thời hoặc nội dung âm thanh Hex; yêu cầu dạng luồng trả về từng dòng JSON chứa các đoạn âm thanh.

Với kết quả dạng luồng, cần ghép nội dung Hex của data.audio theo thứ tự nhận, rồi giải mã và lưu khi nhận được data.status=2. Ngay cả khi trạng thái HTTP là 200, vẫn cần kiểm tra base_resp.status_code; chỉ giá trị 0 mới biểu thị thành công nghiệp vụ.

POST/v1/music_generation

Tạo âm nhạc hoặc bản cover đồng bộ. Khi stream=true, phản hồi trả về từng dòng JSON chứa các đoạn âm thanh trên cùng kết nối HTTP, không tạo tác vụ bất đồng bộ.

Trong kết quả dạng luồng, data.audio là đoạn âm thanh Hex, cần ghép theo thứ tự nhận; data.status=2 cho biết quá trình tạo đã hoàn tất.

Phản hồi dạng luồng luôn trả về các đoạn âm thanh Hex. Khi stream=true, dù truyền output_format=url, gateway hiện tại vẫn có thể bỏ qua giá trị này và trả về luồng Hex.

Xác thực

bearerAuth

Xác thựcBearer <token>

Sử dụng Bearer your-api-key trong Header Authorization.

Vị trí truyền: header

Nội dung yêu cầu

application/json

Tham số tạo âm nhạc hoặc bản cover. Các điều kiện bắt buộc của trường phụ thuộc vào chế độ tạo.

Định nghĩa kiểu TypeScript

Sử dụng kiểu request body trong TypeScript.

model*string

ID mô hình âm nhạc MiniMax khả dụng với API Key hiện tại, chẳng hạn music-3.0, music-2.6 hoặc music-cover.

prompt?string

Mô tả phong cách, cảm xúc và bối cảnh. Bắt buộc trong chế độ nhạc không lời; có thể bỏ qua trong chế độ có lời.

Độ dàilength <= 2000

lyrics?string

Lời bài hát được phân tách bằng dấu xuống dòng. Thường bắt buộc đối với nhạc có lời; có thể tự động tạo khi bật tối ưu lời bài hát và để trống trường này.

Độ dàilength <= 3500

stream?boolean

Có trả về từng dòng JSON chứa các đoạn âm thanh Hex trong phản hồi HTTP hiện tại hay không.

Giá trị mặc địnhfalse

output_format?string

Cách trả về âm thanh. Phản hồi dạng luồng luôn là hex; khi truyền url, gateway hiện tại vẫn có thể bỏ qua giá trị này và trả về các đoạn Hex. URL thường hết hiệu lực sau 24 giờ.

Giá trị mặc định"hex"

Giá trị được phép

"url"
"hex"

audio_setting?

lyrics_optimizer?boolean

Có tự động tạo lời bài hát dựa trên Prompt khi lời bài hát để trống hay không.

Giá trị mặc địnhfalse

is_instrumental?boolean

Có tạo nhạc không lời, không có giọng hát hay không. Khi là true, không yêu cầu lyrics.

Giá trị mặc địnhfalse

audio_url?string

URL âm thanh tham chiếu cho bản cover; không được dùng cùng audio_base64 hoặc cover_feature_id.

Định dạnguri

audio_base64?string

Âm thanh tham chiếu cho bản cover ở dạng Base64; không được dùng cùng audio_url hoặc cover_feature_id.

cover_feature_id?string

ID đặc trưng được trả về từ bước tiền xử lý cover, có hiệu lực trong 24 giờ. Khi sử dụng, phải cung cấp lời bài hát dài từ 10 đến 1000 ký tự.

aigc_watermark?boolean

Có thêm watermark AIGC vào cuối âm thanh hay không; chỉ có hiệu lực với yêu cầu không theo luồng.

Giá trị mặc địnhfalse

Nội dung phản hồi

`application/json`

curl -X POST "https://example.com/v1/music_generation" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "Piano và đàn dây nhẹ nhàng, bình minh, ấm áp và chữa lành, phong cách nhạc phim",    "is_instrumental": true,    "audio_setting": {      "sample_rate": 44100,      "bitrate": 256000,      "format": "mp3"    },    "output_format": "url",    "stream": false  }'

{
  "data": {
    "audio": "https://example.com/music/output.mp3",
    "status": 2
  },
  "trace_id": "04ede0ab069fb1ba8be5156a24b1e081",
  "extra_info": {
    "music_duration": 244262,
    "music_sample_rate": 44100,
    "music_channel": 2,
    "bitrate": 256000,
    "music_size": 7818388
  },
  "analysis_info": null,
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

Tạo âm nhạc và bản cover

Xác thực

Nội dung yêu cầu

Nội dung phản hồi

200application/json

401application/json

`application/json`

`application/json`