Mureka 9.5 API の使い方：5 分で最初の 1 曲を動かす

TL;DR

• これは何か：Mureka 9.5 は音楽生成モデルで、HiAPI 上には 2 つのルートがあります。歌詞から楽曲は完全な歌詞を送信し、リードボーカル、ハモリ、伴奏を含む完成曲を返します。インストルメンタルは説明文だけを送信し、ボーカルなしの器楽を返します。Mureka 9.5 は HiAPI で提供開始済みです。歌詞から楽曲モデルのページを開く とオンラインで試聴・生成できます。新規ユーザー登録で 200 クレジットが付与されます。
• 料金：成功するたびに $0.3215（643 クレジット）で、2 つのルートは同価格です。歌詞の長さや出力時間には関係なく、失敗時は事前扣款が返金されます。$10 で約 31 曲です。
• 最短で動かす方法：モデルページに歌詞を貼り、リードボーカルを選び、「実行」をクリックします。自分のプロダクトに組み込む場合は POST /v1/tasks を使い、model に mureka-9.5/lyrics-to-song を指定し、taskId を取得して URL をポーリング取得します。

Mureka 9.5 とは？

歌詞はすでに完成していて、足りないのは歌い上げられた完成曲です。Mureka 9.5 の歌詞から楽曲ルートは、これを 1 回のリクエストに圧縮します。完全な歌詞を lyrics に入れ、任意の prompt でジャンル、感情、楽器、リズム、ボーカル特性を補い、gender でリードボーカルを女性声か男性声に固定すると、ミックス済みの楽曲が 1 曲返ります。出力は MP3、44.1 kHz ステレオ、約 256 kbps です。

サイト内の 3 つの実例の長さはそれぞれ 1:49、3:02、3:30 で、すべて同じルート、同じ単価から生成されています。自動作詞は提供せず、参考曲やメロディも受け付けません。入力の境界は歌詞とジャンル方向の説明だけです。

まず 2 つの実例を聴く

歌詞から楽曲ルートの City Night Drive と、インストルメンタルルートの Wide-screen Overture は、どちらも 1 回のリクエスト、$0.3215 です。

試聴：City Night Drive、英語インディーポップ、1:49

歌詞から楽曲：City Night Drive · 1:49 · MP3 44.1 kHz ステレオ 256 kbps

試聴：Wide-screen Overture、シネマティック・オーケストラ、3:12

インストルメンタル：Wide-screen Overture · 3:12 · MP3 44.1 kHz ステレオ 256 kbps

2 つのルートの違い

	歌詞から楽曲	インストルメンタル
モデル ID	mureka-9.5/lyrics-to-song	mureka-9.5/instrumental
必須フィールド	lyrics（1–5,000 文字）	prompt（1–1,024 文字）
任意フィールド	prompt（1–2,000 文字）、gender（female / male）	なし
出力	完全なボーカル入り楽曲	ボーカルなしの器楽
長さ	モデルが歌詞構造に基づいて決定	モデルが決定、長さパラメータなし
単価	$0.3215 / 回	$0.3215 / 回

ボーカル入り楽曲が必要なら左、BGM が必要なら右です。どちらも長さは入力できません。サイト内の 3 つのインストルメンタル実例は 3:12、3:08、3:03 です。

オンライン試用：4 ステップ

1. 歌詞から楽曲モデルのページを開く と、ページ上でサイト内の 3 つの実例を直接聴けます。
2. 歌詞欄に完全な歌詞を行ごとに貼り、[Verse 1]、[Chorus] のようなセクションタグで区切ります。
3. スタイル方向欄にジャンル、感情、楽器、ボーカル特性を書き、リードボーカルの性別を女性声か男性声から選びます。
4. 「実行」をクリックし、タスクが終わるまで待つと再生・ダウンロードできます。1 回ごとに $0.3215 です。

インストルメンタルではステップ 2 を器楽の説明文に置き換えます。インストルメンタルモデルのページを開く と同じく 4 ステップです。

初めて試す場合、スタイル方向はこのプロンプトをそのまま使えます：

Warm indie-pop song with a bright female lead vocal, chiming guitars, steady live drums and a wide sing-along chorus, hopeful late-night mood.

このプロンプトで生成 →

開くとスタイル方向欄に入力されるので、あとは自分の 4 行の歌詞を貼り、リードボーカルを女性声に選べば最初の 1 曲を動かせます。

API 接続：4 ステップ

1. 登録後、コンソールで API Key を作成します。
2. POST https://api.hiapi.ai/v1/tasks に model と input を送信します。
3. 返却された data.taskId からタスク ID を取得し、GET /v1/tasks/{taskId} をポーリングするかコールバックを待ちます。
4. ステータスが success になったら、data.output から type=audio の項目を取得し、MP3 をダウンロードします。

歌詞から楽曲：curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mureka-9.5/lyrics-to-song",
    "input": {
      "lyrics": "[Verse 1]\nCity lights are waking up\nEvery window starts to glow\n[Chorus]\nWe keep moving through the night\nEvery shadow turns to gold",
      "prompt": "Warm indie-pop song with a bright female lead vocal, chiming guitars, steady live drums and a wide sing-along chorus, hopeful late-night mood.",
      "gender": "female"
    }
  }'

返却からタスク ID を取得します：

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

インストルメンタル：curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mureka-9.5/instrumental",
    "input": {
      "prompt": "Cinematic orchestral instrumental with a fragile piano ostinato, evolving string swells, low brass and soft timpani, hopeful then resolute, wide film-score reverb."
    }
  }'

ステータス確認：

curl -s https://api.hiapi.ai/v1/tasks/YOUR_TASK_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

data.status は順に queued、handling、success、fail のいずれかになります。

Python：タスク作成、ポーリング、リンク取得

import time
import requests

BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

payload = {
    "model": "mureka-9.5/lyrics-to-song",
    "input": {
        "lyrics": "[Verse 1]\nCity lights are waking up\nEvery window starts to glow\n[Chorus]\nWe keep moving through the night\nEvery shadow turns to gold",
        "prompt": "Warm indie-pop song with a bright female lead vocal, chiming guitars, steady live drums and a wide sing-along chorus, hopeful late-night mood.",
        "gender": "female",
    },
}

resp = requests.post(BASE, headers=HEADERS, json=payload, timeout=30)
task_id = resp.json()["data"]["taskId"]

while True:
    data = requests.get(f"{BASE}/{task_id}", headers=HEADERS, timeout=30).json()["data"]
    if data["status"] in ("success", "fail"):
        break
    time.sleep(10)

if data["status"] == "success":
    audio_url = next(item["url"] for item in data["output"] if item["type"] == "audio")
    print(audio_url)
else:
    print(data.get("error"))

インストルメンタルも同じポーリングロジックを使い、送信内容だけを変えれば単体でも動きます：

import time
import requests

BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

payload = {
    "model": "mureka-9.5/instrumental",
    "input": {
        "prompt": "Cinematic orchestral instrumental with a fragile piano ostinato, evolving string swells, low brass and soft timpani, hopeful then resolute, wide film-score reverb.",
    },
}

task_id = requests.post(BASE, headers=HEADERS, json=payload, timeout=30).json()["data"]["taskId"]

while True:
    data = requests.get(f"{BASE}/{task_id}", headers=HEADERS, timeout=30).json()["data"]
    if data["status"] in ("success", "fail"):
        break
    time.sleep(10)

print(next((item["url"] for item in data.get("output", []) if item["type"] == "audio"), data.get("error")))

出力とフォーマット

各リクエストは MP3 を 1 曲返します。44.1 kHz、ステレオ、約 256 kbps です。ダウンロード時は data.output 内で type が audio の項目を探してください。レスポンスのトップレベルで文字列を探してはいけません。

返却される url は期限切れになるため、DB に保存する前にファイルを自分のストレージへ転送保存してください。

リリース前の注意点

1. コールバックとポーリングの二重化。 リクエストボディに "callback": {"url": "https://yourapp.com/webhook", "when": "final"} を含めると、タスクが終了状態になったときに通知されます。通知は失われる可能性があるため、定時クエリも併用して補完してください。
2. まず taskId を保存し、POST を繰り返さない。 タスク作成のたびに課金されます。クライアントがタイムアウトしたとき、タスクはすでに作成済みかもしれません。taskId を DB に保存し、再試行前にまずステータスを確認してください。
3. 歌詞は行ごとに区切る。 1 行 1 文にし、ヴァースとコーラスの順序を保ち、セクションタグを明確に書くと構造がはるかに安定します。上限は 5,000 文字です。
4. リードボーカルの性別を明示する。 指定しない場合はモデルが決定します。シリーズ曲やブランド曲を作る場合は female または male を固定すると、同じ素材から出る声が一貫します。

FAQ

歌詞を空にしてモデルに自動で書かせられますか？ いいえ。lyrics は必須で、1–5,000 文字です。自動作詞が必要な場合は、自動歌詞に対応した音楽モデルを使用してください。

1 曲の最長はどれくらいですか？ 長さパラメータはなく、長さはモデルが歌詞構造に基づいて決定します。サイト内の 3 つの歌詞から楽曲の実例は 1:49、3:02、3:30 で、3 つのインストルメンタルは 3:12、3:08、3:03 です。

インストルメンタルでボーカルが出ることはありますか？ いいえ。インストルメンタルルートは歌唱ボーカルを生成しません。説明文にリードボーカルと書いても同じです。ボーカルが必要なら歌詞から楽曲ルートに切り替えてください。

生成に失敗した場合、料金はかかりますか？ かかりません。失敗したタスクの事前扣款金額は自動的に返金されます。

今すぐ最初の 1 曲を動かす

上記の curl をターミナルに貼り、YOUR_API_KEY を自分のキーに、歌詞を自分のものに置き換えれば、最初の taskId を取得できます。先に効果を見たい場合は、直接 歌詞から楽曲モデルのページを開く で「実行」をクリックしてください。完全なドキュメントは 歌詞から楽曲の接続ドキュメント と インストルメンタルの接続ドキュメント を参照してください。

関連記事：Mureka 9.5 の価格：1 曲 $0.3215 · Mureka 9.5 vs MiniMax Music 2.6 · Mureka 9.5 プロンプト大全：6 つの実例