MiniMax

MiniMax Music 1.5

minimax-music-1.5

テキストから音楽を生成するモデル。スタイル記述と歌詞に基づいて、ボーカルと伴奏を含む完全な楽曲を一度に生成する。1曲あたり最長約4分で、構造タグによるセクション編成にも対応

minimax-music-1.5

minimax-music-1.5 を試す

入力

Lyrics

作品ギャラリー

すべての作品を見る

出力

パラメータを入力して生成すると、結果がここに表示されます。

料金

minimax-music-1.5 per song

単価	$0.070

位置づけの概要

minimax-music-1.5 は MiniMax のテキスト・トゥ・ミュージックモデルで、HiAPI.ai の統一インターフェースから呼び出せます。スタイルプロンプトと構造タグ付きの歌詞を入力するだけで、ボーカル歌唱とレイヤー化された器楽を含む完成楽曲を生成できます。編曲・ミックス・歌唱はモデルが担うため、クリエイター自身が演奏や録音を行う必要はありません。完成した楽曲が必要な動画やショートドラマの BGM、バーチャルアーティストのデモ、音楽制作の経験はないが感情やシーンに合わせて手早く楽曲を作りたい開発者の導入に適しています。

主な特長

歌詞で楽曲構造を直接設計——歌詞は [intro][verse][chorus][bridge][outro] の構造タグに対応し、段落ごとに内容を指定することで、生成曲の段落のつながりがより自然になります。
プロンプトでスタイルと感情を制御——スタイルプロンプトでジャンル、感情、編成を記述でき、モデルがそれに基づいて編曲とボーカル歌唱を行うため、手動でのパラメータ調整を削減できます。
出力仕様を必要に応じて指定——mp3、wav、pcm の 3 形式に対応し、サンプリングレートとビットレートを指定できるため、後段の再生や編集パイプラインに合わせやすくなります。

機能説明

歌詞駆動の楽曲全体生成：10〜600 文字の歌詞と 10〜300 文字のスタイルプロンプトを送信すると、モデルがボーカルと伴奏を含む楽曲を一度に生成し、開発者はそのまま利用可能な音声ファイルを取得できます。

構造タグによる段落設計：歌詞内で [intro][verse][chorus] などのタグを使って段落を区切ることで、A メロ・サビの位置や繰り返しの関係が明確になり、完成曲の構成の一貫性が向上します。

スタイルと感情のテキスト制御：プロンプトでジャンル、感情、楽器編成を記述でき、さまざまな題材の BGM ニーズに対応します。スタイルごとにモデルを切り替える必要はありません。

出力音声パラメータを選択可能：リクエスト内で音声フォーマット、サンプリングレート、ビットレートを指定でき、下流のプレイヤーやポストプロセス工程の要件に応じた仕様のファイルを出力できます。

活用シーン

ショート動画・ショートドラマ制作者の BGM 制作——ストーリーの感情に合わせてプロンプトを書き、歌詞を添えることで、ボーカル入りの主題歌や挿入歌を生成し、動画編集や公開にそのまま利用できます。
バーチャルアーティスト運営者向けの楽曲デモ——スタイルプロンプトと歌詞で歌唱入りの完成楽曲を素早く制作し、バーチャルシンガーの作品や対外展示用のデモ素材として活用できます。
音楽経験のないクリエイターが手早く楽曲を制作——感情やシーンの説明と自作の歌詞を用意するだけで、編曲・ミックス済みの楽曲を取得でき、コンテンツ公開やイベントでの利用に適しています。

制限と選定のアドバイス

ユーザーが提供した歌詞に基づく楽曲生成のみに対応し、自動での作詞機能は提供していません。また、純器楽モードにも対応していないため、ボーカルなしの BGM が必要な場合は他のモデルを選択してください。歌詞は最大 600 文字で、長文や多段落の複雑な構成では内容を精選して取捨選択する必要があります。完成品質はプロンプトと歌詞の質に依存するため、構造タグを使って段落を区切ることをお勧めします。より高度な制御機能が必要な場合は、同シリーズの上位バージョンを検討してください。

生成タスクの作成

POST https://api.hiapi.ai/v1/tasks

ヘッダー

Authorizationstring必須

アカウントの API キー。すべてのリクエストで必須です。例：Bearer YOUR_HIAPI_API_KEY。API キーを取得

Content-Typestring任意

リクエストボディは常に JSON として解析されます。送信する場合は application/json（charset 付き可）のみ受け付け、他の値は 415 を返します。例：application/json。

Idempotency-Keystring任意

冪等キー。最大 255 バイト。同じアカウントで同じキーの再試行はタスクを 1 つだけ作成し、リプレイは最初の taskId を返します。

冪等キー

ネットワークタイムアウトやクライアントの自動再試行時、同じキーではタスクを 1 回だけ作成し、二重課金は発生しません（適用範囲 = API キーのアカウント）。業務側の一意識別子（例："order-42"）をキーに使うことを推奨します。同じキーのリプレイは最初の taskId を返し、キーは初回送信から 24 時間で失効します。詳細なシナリオ表は統一非同期 API の紹介ページをご覧ください。

ボディ

modelstring必須

現在の固定値：minimax-music-1.5

routestring任意

現在の固定値：default

inputobject必須

minimax-music-1.5 とルート default の業務パラメータオブジェクト。下のパラメータ表を参照してください。

lyricsstring必須minLength 10maxLength 600

楽曲の歌詞。1行につき1文（\n で区切り）、長さは10～600文字に制限され、構造タグ [intro][verse][chorus][bridge][outro] をサポートします。

promptstring必須minLength 10maxLength 300

音楽スタイルを制御するテキストプロンプト。曲調、ムード、編曲を記述するために使用し、長さは10～300文字に制限されます。

bitrateinteger任意デフォルト: 256000

出力音声のビットレート。単位は bps、デフォルトは 256000。

オプション：3200064000128000256000

sample_rateinteger任意デフォルト: 44100

出力音声のサンプリングレート。単位は Hz、デフォルトは 44100。

オプション：16000240003200044100

audio_formatstring任意デフォルト: "mp3"

出力音声フォーマット。デフォルトは mp3。

オプション：mp3wavpcm

callbackobject任意

終了状態の通知設定。省略した場合はコールバックされず、呼び出し側でポーリングします。

コールバック（Webhook）

作成時に callback.url を指定すると、タスク終了時に HiAPI があなたのサービスへ POST し、ポーリングが不要になります。コールバックのリクエストボディはタスク詳細と同構造です。署名検証・再送・冪等の詳細は統一非同期 API 紹介ページのコールバック説明を参照してください。

urlstring必須

callback を指定する場合は必須。タスク終了後にこの URL へ POST します。有効な http(s) URL である必要があります。

whenstring任意デフォルト: "final"

現在は final のみ対応（success / fail の両方で通知）。

オプション：final

storagestring任意デフォルト: "temp"

成果物の保存期間：temp（デフォルト・約 7 日）または persistent（長期保存・サイズ課金）。残高不足や保存上限超過の場合は temp に自動降格します。実際に適用された段階はタスク詳細レスポンスで確認できます。

オプション：temppersistent

リクエスト例

# 非同期タスクを送信。成功すると即座に taskId を返します（生成完了は待ちません）
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax-music-1.5",
  "input": {
    "lyrics": "…",
    "prompt": "…",
    "bitrate": 256000,
    "sample_rate": 44100,
    "audio_format": "mp3"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "minimax-music-1.5",
    input: {
      "lyrics": "…",
      "prompt": "…",
      "bitrate": 256000,
      "sample_rate": 44100,
      "audio_format": "mp3"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "minimax-music-1.5",
        "input": {
          "lyrics": "…",
          "prompt": "…",
          "bitrate": 256000,
          "sample_rate": 44100,
          "audio_format": "mp3"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

タスク詳細の取得

GET https://api.hiapi.ai/v1/tasks/:id

レスポンスフィールド

taskIdstring必須

タスク ID。先頭は固定で tk-hiapi-。

modelstring必須

解決済みのモデル完全名。route パラメータで送信したタスクは base@route（例：gpt-image-2/text-to-image@ext）を返し、それ以外は送信時のモデル名と同一です。

routestring任意

route パラメータを明示して送信したタスクでのみ出現し、送信時の値をエコーします。

statusstring必須

タスク状態。

ステータス値

queued キュー投入済み、未開始。 handling 処理中。 archiving 処理完了、成果物準備中。 success 終端：完了。成果物利用可能（output を返却）。 fail 終端：失敗（error を返却）。送信後は status で判断します：success と fail が終端、それ以外は非終端です。1〜3 秒間隔で終端までポーリングすることを推奨します。成功したら output[].url から成果物をダウンロードし、expireAt までに保存先へ転送してください。長期保存が必要な場合は作成時に storage: "persistent" を指定します。

creatednumber必須

タスク作成時刻（Unix 秒）。

completednumber必須

終了状態になった Unix 秒。非終端では 0 固定。

outputarray任意

status == success のときのみ出現。成果物リスト — 常に配列で、1 タスクで複数の type を同時に返すことがあります（例：video + first_frame）。

Array [ object ]

配列要素

urlstring必須

成果物の URL。直接ダウンロードできます。

typestring必須

現在の候補値：video、image、audio、first_frame、last_frame、thumbnail。今後拡張される可能性があります。

expireAtnumber必須

成果物にアクセスできる期限（Unix 秒）。期限までにダウンロードまたは転送してください。

errorobject任意

status == fail のときのみ出現。

codestring必須

業務エラーコード。

messagestring必須

エラーの説明。

レスポンス例

成功

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

処理中（非終端）

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

失敗

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}