Mureka api tutorial

reAPI の Mureka API リクエストには、モデル ID mureka-v9-song と歌詞 lyrics が必要です。 文書化された処理では、まずタスク ID が返り、完了後に楽曲 URL を取得します。1 回のリクエストで最大 3 曲、出力形式は mp3、wav、flac に対応します。^[1]

本稿は、この reAPI インターフェースを対象に、2026 年 10 月 22 日に確認した公開ドキュメントと実装に基づいています。例を送信して音声を生成するテストは行っていません。リクエストの組み立てと結果処理を示すものであり、生成速度、音楽の品質、参照への忠実度、最新モデルであることを示すものではありません。表紙は概念図で、音声生成の実績ではありません。

要点

歌う言葉は lyrics、音楽の方向性は任意の prompt に分けます。^[1]
まず number_of_songs: 1 を使います。指定範囲は 1–3 で、曲数は料金に影響します。^[1]
送信後に返る id を保存し、そのタスクを終了まで照会します。^[2]
completed 後に output.audio_urls を読み、長期保存が必要なら自分のストレージにコピーします。^[2]

mureka api key

以下のリクエストは reapi.ai 宛てで、reAPI の API キーが必要です。reAPI ダッシュボードの API Keys でキーを作成し、表示されたときに保存してください。各リクエストに Authorization: Bearer ... を付けます。認証ガイドに作成手順と認証エラーが記載されています。^[3]

キーはサーバー側かシークレット管理サービスに保管します。以下のシェル変数 REAPI_API_KEY はその秘密値を指し、本稿がキーを提供するわけではありません。実際のキーをブラウザー側の JavaScript、スクリーンショット、公開リポジトリに含めないでください。他サービスのアカウントやキーは reAPI 発行の認証情報を代替しません。

mureka api docs

Mureka V9 Song リファレンスでは、歌う文字と音楽への指示を分けています。lyrics は必須で最大 3000 文字、prompt は任意で最大 1024 文字です。後者にはジャンル、雰囲気、楽器、声の質感、テンポなどを記述できます。^[1]

例えば、歌詞の A メロやサビを lyrics に、「柔らかなピアノのポップス、控えめな打楽器」という方向性を prompt に入れます。これは入力例であり、検証済みの作り方ではありません。歌わせたい言葉をスタイル指定だけに入れても、必須の歌詞フィールドを満たしません。

フィールド	文書化された入力	初回の選択
`model`	`mureka-v9-song`	正確な識別子を使います。
`lyrics`	必須、最大 3000 文字	自分の歌詞を指定します。
`prompt`	任意、最大 1024 文字	希望する音楽のスタイルを書きます。
`number_of_songs`	整数 1–3、既定値 1	1 曲なら 1 を指定します。
`output_format`	`mp3`、`wav`、`flac`、既定値 `mp3`	用途に合う形式を選びます。
`reference_id`、`vocal_id`、`melody_id`	任意の既存参照 ID	有効な ID がなければ省略します。

参照フィールドが受け付けるのは ID であり、ローカルファイル名、音声 URL、自由記述ではありません。本稿ではアップロード先や ID の発行手順を提供していません。歌詞とスタイルだけの基本的な処理では省略し、該当フィールド向けの有効な参照 ID を既に持っている場合だけ追加してください。参照項目があること自体は、生成曲が参照にどれほど忠実かを証明しません。^[1]

Mureka api tutorial

以下はドキュメントに基づくリクエスト例です。短い歌詞は説明用の文章です。実行する場合は自分の素材に置き換え、サーバー環境にキーを設定してください。生成リクエストの送信には料金が発生することがあります。

curl https://reapi.ai/api/v1/audio/generations \
  -H "Authorization: Bearer $REAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mureka-v9-song",
    "lyrics": "Morning light across the floor\nI leave a note beside the door",
    "prompt": "Soft piano pop with restrained percussion",
    "number_of_songs": 1,
    "output_format": "mp3"
  }'

POST が返した id を送信時の設定と一緒に保存します。その値を TASK_ID に設定し、同じ認証方法で状態を照会します。

curl "https://reapi.ai/api/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $REAPI_API_KEY"

アプリケーションの次の動作は、照会結果に応じて分けます。^[2]

`status`	アプリケーションの処理
`processing`	待機状態を維持します。タスク ID は完成した音声ファイルではありません。
`completed`	`output.audio_urls` を読み、返されたファイルを利用者に提示します。
`failed`	`error` と `usage.credits` を確認し、成功結果の待機を終了します。

アプリ側のポーリングがタイムアウトしても、生成失敗とは限りません。自動的に別の生成を依頼せず、タスク ID を保持して再照会してください。タスク仕様にポーリングとエラー処理が記載されています。HTTP 429 では Retry-After に従い、間隔を空けずに同じリクエストを繰り返さないでください。

mureka api pricing

文書化された課金単位は生成曲です。number_of_songs が曲数を制御し、prompt、出力形式、任意の参照フィールドは、このモデルの仕様では独立した価格要素ではありません。^[1] Mureka V9 Song モデルページで、希望する曲数の現在の見積もりを確認してください。

ポーリング自体はクレジットを消費しません。usage.credits は決済後の整数クレジット要約なので、status と一緒に読みます。processing 中のゼロは無料生成を意味しません。失敗時にはゼロまたは保持された料金が表示される場合があり、すべての失敗で全額返金されるとは限りません。^[2] 別のバリエーション用に送る POST は状態照会ではなく、新たな生成依頼です。

Mureka api download

completed になったら、1 曲だけでも output.audio_urls を配列として処理します。仕様では生成曲ごとに URL が 1 つ返り、指定した出力形式が使われます。複数曲を指定できるアプリで、最初の結果だけを保存しないようにしてください。^[1]

保存が必要ならファイルをダウンロードし、自分の保持方針に従って管理します。結果 URL の永久保存はタスク仕様で保証されていません。^[2] タスク ID、入力設定、状態、保存先を関連付けて、処理中のジョブと完成したが未コピーの曲を区別できるようにします。

Mureka API の初回実装では、上の最小リクエストから始め、3 つの状態を処理し、実際の音声を確認してから本番の流れに組み込んでください。現在の見積もりはモデルページ、完全なフィールド仕様は API リファレンスにあります。

関連する API 検索

[1] Mureka V9 Song API. 確認日：2026 年 10 月 22 日.

[2] タスク. 確認日：2026 年 10 月 22 日.

[3] 認証. 確認日：2026 年 10 月 22 日.

Mureka api tutorial

mureka api key

mureka api docs

Mureka api tutorial

mureka api pricing

Mureka api download

mureka v9 api

mureka api documentation

mureka api cost

mureka api platform