はじめに
歌と BGM のエンドポイントは、最大 1,024 文字のスタイル指定と最大 5,000 文字の歌詞を受け付けます。伴奏曲には歌詞なしで instrumental を使い、出力形式と受け取るバージョン数を選びます。
| 項目 | 値 |
|---|---|
| 入力 | テキスト |
| 出力 | 音声 |
| スタイルの入力 | prompt:最大 1,024 文字 |
| 歌詞の入力 | lyrics:セクションタグを含めて最大 5,000 文字 |
| バージョン数 |
|
| ファイル形式 | mp3, wav, flac |
| 公開元が示す長さ | Mureka によると歌は約 5:30、BGM は約 4:30 |
| フォークで確認した結果 | 約 2:31、アコースティックギターと温かみのある男性ボーカル |
| 課金する数量 | V9 の各バージョンを 1 曲として課金します。インストゥルメンタルも歌入りも同じ単価です。 |
主な機能とハイライト
温かい男性の声によるスロー R&B
夜が続いてほしいと願うヴァースとサビがスロー R&B になりました。返された MP3 では温かい男性の声が指定の歌詞を歌っています。この音楽の方向を示す具体例として試聴できます。
2 分 31 秒のフォークソング
ヴァースとサビにアコースティックギターの説明を添えました。Mureka V9 は温かい男性の声で入力の言葉を歌う 2:31 の曲を返しました。
学習用の lo-fi 伴奏
instrumental を有効にして歌詞を省くと、同じモデルから BGM 用のピアノ入りのゆっくりした lo-fi ビートが得られました。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | ジャンル、編成、雰囲気、テンポ、声などを 1,024 文字以内で指示します。説明によって曲単価は変わりません。 1 文字以上 · 1024 文字以内 |
lyrics | いいえ | 歌う言葉を [Verse] や [Chorus] などで区切り、最大 5,000 文字で渡します。インストゥルメンタルでは歌詞を省略します。 1 文字以上 · 5000 文字以内 |
instrumental | いいえ | 有効にすると、歌詞や歌声を使わず prompt から BGM を作ります。歌と BGM は V9 の同じ単価で利用できます。 デフォルト値: |
num_outputs | いいえ | V9 のバージョン数を 1〜3 に設定します。各バージョンに料金がかかるため、数を増やすと請求額も増えます。 |
output_format | いいえ | 返却する音声形式を mp3、wav、flac から選べます。V9 は形式の選択ではなく曲単位で課金します。 |
料金
$0.084 / 曲
V9 は num_outputs で指定した各バージョンに課金します。歌と BGM は同じ単価です。失敗したリクエストは無料で、V9 の曲単価は V9.5 より低くなっています。
ユースケース
歌詞の原稿を歌で確かめる
ヴァースとサビを歌唱デモにしてから歌詞を見直せます。アコースティックフォークのテストでは、温かい男性の声で指定の言葉を歌う約 2:31 の曲が返りました。
落ち着いた R&B の雰囲気を探る
ゆったりしたグルーヴに声の方向と深夜を描く歌詞を組み合わせます。新しい例では、温かい男性の声が指定のヴァースとサビを歌うスロー R&B の MP3 が返りました。
静かな学習用サウンドを作る
歌詞の不要な伴奏には instrumental を使います。学習用サンプルはピアノとレコードノイズのある遅めの lo-fi ビートになりました。実際の利用環境でも聴いて確認してください。
同じ説明から複数テイクを比較
候補を並べて聴きたい場合は 2–3 バージョンを依頼します。そのリクエストでは歌詞と音楽の方向を統一し、同じ条件で演奏を評価します。すべての版が課金対象です。
共同制作に渡す音声を準備
共同制作者が求める形式に合わせて MP3、WAV、FLAC を選びます。後の修正の出発点が分かるよう、曲と元歌詞、スタイルの説明をまとめて保存します。
プロンプトガイドと実践のヒント
V9 のアレンジを説明します
アコースティックギターと焚き火の雰囲気のインディーフォークなど、音楽の指示を prompt に書きます。
歌詞か伴奏曲かを選びます
歌なら lyrics にタグ付きの歌詞を入れます。伴奏曲なら instrumental を有効にし、歌詞のテキストを省略します。
バージョン数と書き出しを設定します
音楽のリクエストを送る前に、出力数を 1〜3 にし、mp3、wav、flac の形式を選びます。
音楽の説明から歌や伴奏へ
Mureka V9 はスタイルの指示と入力歌詞を組み合わせて歌唱曲を作ります。同じ Song and Background Music エンドポイントで、instrumental を有効にして lyrics を空にするとインストゥルメンタルも作れます。歌として試したい言葉がある場合や、雰囲気と楽器編成を説明できる伴奏が必要な場合に使います。
V9 にはバージョン数の設定もあります。同じ音楽のアイデアから 1、2、3 候補を生成でき、それぞれに課金されます。追加の曲を無料の別案として扱わず、聴き比べる計画に合わせて選んでください。
パラメータと入力の準備
| 項目 | 値 | 説明 |
|---|---|---|
| prompt | 最大 1,024 文字 | ジャンル、楽器、雰囲気、テンポ、声の特徴を記述します。 |
| lyrics | 最大 5,000 文字 | [Verse]、[Chorus] などを付けて歌う言葉を入力します。 |
| instrumental | BGM 用に有効化 | lyrics は空にし、音楽の方向を prompt に書きます。 |
output_format | mp3, wav, flac | 制作に合う音声形式を選びます。 |
num_outputs | 1、2、3 | 受け取る課金対象バージョンの数です。 |
歌唱曲では編曲の指示を prompt、歌う言葉を lyrics に分けます。ジャンルで全体の方向を決め、主役の楽器と伴奏を指定すると、後から意図した編成を評価しやすくなります。伴奏だけなら、歌詞の中に歌わないよう書くのではなく instrumental を使います。
評価しやすい説明を書く
楽器の役割を決めます
たとえば、控えめなアコースティックフォーク、フィンガーピッキングのギターを主役に、柔らかな打楽器、温かい男性の声、夕方の内省的な雰囲気という方向を試せます。これは説明用の例で、追加の検証結果ではありません。無関係な形容詞を並べるより、聴いて確認できる選択を示せます。
lo-fi の BGM ではピアノなどの主な音、ビートの速さ、編曲の密度を説明します。静かな学習用音楽と主役として聴く曲では、必要な音楽の動きが違います。instrumental で制作方法を切り替えても、その性格はプロンプトで指定します。
歌詞を読みやすく保ちます
[Verse] と [Chorus] を独立した行に置き、その後に各部分の歌詞を書きます。改行で区切ると原稿と歌唱を比較しやすくなります。制作指示を混ぜず、試したい言葉を書き出してください。歌い回しや構成の変化は耳で確認します。タグは各行の正確な時間を決めるものではありません。
同じ説明で候補を比べます
保存時は歌詞と音楽の方向をまとめて残します。複数出力では、声の特徴、言葉の明瞭さ、指定楽器、サビへの自然な移行を同じ基準で聴きます。後のリクエストでは音楽の指示を 1 つずつ変え、比較の目的を明確にしてください。
当社のサンプルで得られた音楽
- 深夜の R&B: 新しい MP3 は、夜が続くことを願う指定のヴァースとサビを、温かい男性の声で歌うスロー R&B です。元の説明には柔らかなエレクトリックピアノと深夜のベースグルーヴを指定しました。観察で確認したのは曲調と歌唱で、各楽器を個別に測定したわけではありません。
- 旅のフォーク: 入力歌詞がアコースティックギターと温かい男性の声の曲になり、約 2 分 31 秒でした。この長さはその録音に限った値です。
- 学習用 lo-fi: instrumental を有効にした説明から、歌声のない、柔らかなピアノとレコードノイズを含む遅めの lo-fi ビートが返りました。
これらは記載した入力から得た個別の結果です。処理時間、一定の長さ、後のリクエストでの同一結果を示していません。制作に使う前に、サビからの移行や曲の終わりまで通して聴いてください。
料金とバージョン数
課金は生成した V9 のバージョン数に応じます。歌唱曲とインストゥルメンタルは同じ曲単価で、失敗したリクエストは無料です。2–3 出力なら、その分だけ課金数量が増えます。金額はこのガイドで固定せず、送信前に Mureka V9 のモデルページ で確認してください。
長さ、保存期間、モデルの選択
Mureka は歌唱曲が最大約 5 分 30 秒、BGM が最大約 4 分 30 秒と説明しています。公開元の上限の目安であり、各曲の目標時間ではありません。記載の設定に長さの指定はないため、時間の条件がある制作では実際の長さを確認します。
生成音声は 14 日後に削除されます。選んだテイクを期間内に保存し、prompt、lyrics、形式、版数を一緒に残します。
任意の female または male の vocal_gender を使いたく、曲単価が高くてもよい場合は Mureka V9.5 を選べます。V9 には num_outputs と低い曲単価があります。MiniMax Music 3.0 も同じ素材で試せるモデルです。実際に得た音楽と必要な設定で比較してください。
Mureka V9 は生成したバージョンごとの課金です。音楽のリクエストが失敗した場合は料金が発生しません。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "mureka/v9/text-to-audio",
"input": {
"prompt": "Calm ambient pads with a slow rising motif",
"num_outputs": 1,
"output_format": "mp3"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。

