AGTCloud API Docs
文件指南API Reference整合與資源更新與幫助
音樂生成MiniMax Music

音樂與翻唱生成

使用 MiniMax 音樂協議同步生成音樂或翻唱結果。

此 API 在同一個同步 HTTP 請求中生成音樂或翻唱結果。一般請求可回傳暫時音訊 URL 或 Hex 音訊內容;串流請求會逐行回傳 JSON 音訊分片。

串流結果需要依接收順序串接 data.audio 的 Hex 內容,並在收到 data.status=2 後完成解碼與儲存。HTTP 狀態為 200 時仍應檢查 base_resp.status_code,只有值為 0 才表示業務成功。

POST/v1/music_generation

同步生成音樂或翻唱結果。當 stream=true 時,回應會在同一條 HTTP 連線中逐行回傳 JSON 音訊分片,不會建立非同步任務。

串流結果中的 data.audio 為 Hex 音訊片段,應依接收順序串接;data.status=2 表示生成完成。

串流回應固定回傳 Hex 音訊分片。當 stream=true 時,即使傳入 output_format=url,目前閘道仍可能忽略此值並回傳 Hex 串流。

授權

bearerAuth
授權Bearer <token>

在 Authorization Header 中使用 Bearer your-api-key。

傳遞位置: header

請求主體

application/json

音樂或翻唱生成參數。欄位的條件式必填關係取決於生成模式。

TypeScript 型別定義

在 TypeScript 中使用 request body 型別。

回應主體

application/json

application/json