ドキュメント

Mubert AI音楽API

バージョン 3.0

目次

Start here

Quick Start

Install Skill

認証

ライセンス

ユーザー登録

トラック生成

トラックストア

Mubert 音楽ライブラリ

トラック

スワッガー

Mubert AI Music API v3へようこそ！

このAPIを使用すると、アプリ、ゲーム、またはサービスにトラック生成および音楽ストリーミング機能を統合できます。APIの利用を開始するには、Mubertチーム（[email protected]）にAPIキーを申請してください。

REST API は SSL (HTTPS) 上で JSON のみを使用して通信します。すべてのエンドポイント URL は https://music-api.mubert.com/api/v3/ で始まります（ストリーミング URL は除く。それらは https://stream.mubert.com/b2b/v3/ で始まります）

パラメータは JSON にシリアライズし、リクエスト本文で送信する必要があります。
メディアタイプの指定として application/json を使用してください。

APIには主なディレクトリが2つあります:

  • サービス — https://music-api.mubert.com/api/v3/service/ — 会社がライセンスと顧客を管理するために使用されます。

  • 公開 — https://music-api.mubert.com/api/v3/public/ — 顧客がストリーミング機能とトラックを受け取るために使用されます。

Start here

  1. Choose a self-serve plan.

  2. Your company credentials arrive by email after checkout.

  3. Install the Mubert skill or copy the REST quickstart below.

  4. Make one request and save the returned track before its URL expires.

Already paid? Find your credentials in the email sent after checkout. Need help with a custom setup? Contact the Mubert team →

Quick Start

Three requests in this order: check what your license allows, search the curated library, and only then spend a generation.

1. Check capabilities, limits, and remaining quota

curl -X GET "https://music-api.mubert.com/api/v3/service/licenses" \
  -H "company-id: COMPANY_ID" \
  -H "license-token: LICENSE_TOKEN" \
  -H "Content-Type: application/json"

2. Search the curated library before generating

curl -X GET "https://music-api.mubert.com/api/v3/public/library/tracks\
?bpm=120&duration=30" \
  -H "customer-id: CUSTOMER_ID" \
  -H "access-token: ACCESS_TOKEN" \
  -H "Content-Type: application/json"

3. Generate one track when the library has no match

curl -X POST "https://music-api.mubert.com/api/v3/public/tracks" \
  -H "customer-id: CUSTOMER_ID" \
  -H "access-token: ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "playlist_index": "PLAYLIST_INDEX",
    "duration": 30,
    "format": "mp3",
    "mode": "loop",
    "intensity": "medium"
  }'

Generation is asynchronous: poll the track by its id or use a webhook. Track URLs expire, so save the file you need to keep. Building with a coding agent? Install the Mubert skill and let it make the first request for you.

Install Mubert Skill

Github: https://github.com/MubertAI/skills

npx skills add MubertAI/skills

認証

REST API は API キーによる認証を受け付けます。

企業向け

curl -X POST "https://music-api.mubert.com/api/v3/service/*" \
-H "Content-Type: application/json" \
-H "company-id: COMPANY_ID" \
-H "license-token: LICENSE_TOKEN"

お客様向け

curl -X POST "https://music-api.mubert.com/api/v3/public/*" \
-H "Content-Type: application/json" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN"

REST API は SSL (HTTPS) 上で JSON のみを使用して通信します。すべてのエンドポイント URL は https://music-api.mubert.com/api/v3/ で始まります（ストリーミング URL は除く。それらは https://stream.mubert.com/b2b/v3/ で始まります）

service ディレクトリには COMPANY_ID と LICENSE_TOKEN のペアを使用し、public ディレクトリには CUSTOMER_ID と ACCESS_TOKEN のペアを使用します。

COMPANY_ID / LICENSE_TOKEN / CUSTOMER_ID / CUSTOMER_TOKEN を実際のトークンに置き換える必要があります。

ライセンス

お客様の利便性のため、1つの会社で、それぞれ独自の機能と制限を持つ複数のライセンスを利用できるようにしています。これにより、ユーザーを異なるライセンスに分けることができます。既定では、会社には1つのライセンスがあり、ほとんどの場合、これで十分です。

ライセンスと制限に関する情報を確認できます。

モデルのライセンスをGETリクエストで使用します

curl -X GET "https://music-api.mubert.com/api/v3/service/licenses" \
-H "company-id: COMPANY_ID" \
-H "license-token: LICENSE_TOKEN"

特定のライセンスに関する情報も取得できます

curl -X GET "https://music-api.mubert.com/api/v3/service/licenses/LICENSE_ID" \
-H "company-id: COMPANY_ID" \
-H "license-token: LICENSE_TOKEN"

応答

200 OK

{
    "data": {
        "id": "9e113460-1125-4c09-83c0-94a3b36b0bf3",
        "company_id": "9e1133df-0ac2-4824-bb1a-827fb0698380",
        "type": "有料",
        "status": "有効",
        "webhook_url": "https://b2b3-webhook.mubert.com/",
        "webhook_enabled": true,
        "track_expiration_time": 900,
        "allow_all_features": true,
        "features": [
            "トラック",
            "ttm",
            "itm",
            "ストリーミング"
        ],
        "allow_all_bitrates": true,
        "bitrates": [
            32,
            96,
            128,
            192,
            256,
            320
        ],
        "default_bitrate": 128,
        "allow_all_intensities": true,
        "intensities": [
            "低",
            "中",
            "高"
        ],
        "default_intensity": "高",
        "allow_all_formats": true,
        "track_formats": [
            "mp3",
            "wav"
        ],
        "default_format": "mp3",
        "allow_all_modes": true,
        "track_modes": [
            "トラック",
            "ジングル",
            "ループ",
            "ミックス"
        ],
        "default_mode": "トラック",
        "expired_at": "2025-02-01T00:00:00.000000Z",
        "license_limits": {
            "id": "9e113460-140f-409d-a5e8-c755bd6cf7f2",
            "license_id": "9e113460-1125-4c09-83c0-94a3b36b0bf3",
            "max_track_duration": 1500,
            "max_concurrent_track_generations": -1,
            "total_tracks_count": 5,
            "total_tracks_count_limit": -1,
            "total_tracks_duration": 306,
            "total_tracks_duration_limit": -1,
            "monthly_tracks_count": 5,
            "monthly_tracks_count_limit": -1,
            "monthly_tracks_duration": 306,
            "monthly_tracks_duration_limit": -1,
            "daily_tracks_count": 0,
            "daily_tracks_count_limit": -1,
            "daily_tracks_duration": 0,
            "daily_tracks_duration_limit": -1,
            "total_streaming_duration": 70,
            "total_streaming_duration_limit": -1,
            "monthly_streaming_duration": 70,
            "monthly_streaming_duration_limit": -1,
            "daily_streaming_duration": 0,
            "daily_streaming_duration_limit": -1,
            "customers_count": 2,
            "customers_count_limit": 5,
            "customer_max_concurrent_track_generations": -1,
            "customer_total_tracks_count_limit": -1,
            "customer_total_tracks_duration_limit": -1,
            "customer_monthly_tracks_count_limit": -1,
            "customer_monthly_tracks_duration_limit": -1,
            "customer_daily_tracks_count_limit": 5,
            "customer_daily_tracks_duration_limit": -1,
            "customer_total_streaming_duration_limit": -1,
            "customer_monthly_streaming_duration_limit": 0,
            "customer_daily_streaming_duration_limit": -1,
            "daily_reset_at": "2025-01-01T00:00:00.000000Z",
            "monthly_reset_at": "2025-01-01T00:00:00.000000Z"
        }
    }
}

これはライセンスモデルです。ここでは、ライセンスの機能、デフォルトパラメーター、制限、および統計情報を確認できます。

一部の制限値に-1が見られることがありますが、これは制限が設定されていないこと（無制限）を意味します。

ウェブフック

このバージョンのAPIでは、ライセンスにWebhookを追加でき、トラック生成プロセスのステータスに関する通知を受け取ることができます。

PUT メソッドを使用して webhook を設定します

curl -L -X PUT "https://music-api.mubert.com/api/v3/service/licenses/LICENSE_ID" \
-H "company-id: COMPANY_ID" \
-H "license-token: LICENSE_TOKEN" \
-H "Content-Type: application/json" \
-d "{
    \"webhook_url\": \"https://YOUR_WEBHOOK_URL\",
    \"webhook_enabled\": true
}"

更新されたライセンスモデルを受け取ります。

Webhook を追加すると、トラックモデルを含むメッセージの受信が始まります。たとえば次のようになります:

{
    "id": "TRACK_ID",
    "session_id": "SESSION_ID",
    "parent_session_id": null,
    "playlist_index": "1.0.0",
    "prompt": null,
    "duration": 61,
    "intensity": "高",
    "mode": "トラック",
    "key": "A#",
    "bpm": 120,
    "generations": [
    {
        "session_id": "GENERATION_SESSION_ID",
        "format": "mp3",
        "bitrate": 128,
        "status": "完了",
        "generated_at": "2025-01-01T00:00:00.000000Z",
        "expired_at": "2025-01-02T00:00:00.000000Z",
        "created_at": "2025-01-01T00:00:00.000000Z",
        "url": "YOUR_TRACK_LINK"
    }]
}

track モデルの詳細は、Track generation のセクションでご確認いただけます。

ユーザー登録

製品（サービス）の各エンドユーザーは、固有のトークンの組み合わせで識別されます: customer-id と access-token。これらのトークンは、コンテンツや機能にアクセスするために必要です。

音楽を提供したいユーザー数と同じだけのお客様を作成してください。

作成するには、以下に説明する customers モデルを POST リクエストで使用します。

curl -X POST "https://music-api.mubert.com/api/v3/service/customers" \
-H "Content-Type: application/json" \
-H "company-id: COMPANY_ID" \
-H "license-token: LICENSE_TOKEN" \
-d "{
    \"custom_id\": \"YOUR_CUSTOM_ID\"
}"

入力パラメータ

  • custom_id — あなたの内部で一意の顧客IDで、ラテン文字、数字、および許可された特殊文字: ".", "_", "@", "-" を含めることができ、255文字を超えてはいけません。

  • company-id および license-token — Mubertチームによって提供されます

成功した場合は、200 OKレスポンスとJSONレスポンスを返します。

顧客モデルがあります

{
    "data": {
        "id": "CUSTOMER_ID",
        "company_id": "COMPANY_ID",
        "custom_id": "YOUR_CUSTOM_ID",
        "status": "有効",
        "access": {
            "id": "ACCESS_ID",
            "customer_id": "CUSTOMER_ID",
            "license_id": "LICENSE_ID",
            "token": "ACCESS_TOKEN",
            "expired_at": "2025-02-01T00:00:00.000000Z",
            "customer_limits": {
                "id": "CUSTOMER_LIMITS_ID",
                "customer_id": "CUSTOMER_ID",
                "license_id": "LICENSE_ID",
                "max_concurrent_track_generations": -1,
                "total_tracks_count": 0,
                "total_tracks_count_limit": -1,
                "total_tracks_duration": 0,
                "total_tracks_duration_limit": -1,
                "monthly_tracks_count": 0,
                "monthly_tracks_count_limit": -1,
                "monthly_tracks_duration": 0,
                "monthly_tracks_duration_limit": -1,
                "daily_tracks_count": 0,
                "daily_tracks_count_limit": 5,
                "daily_tracks_duration": 0,
                "daily_tracks_duration_limit": -1,
                "total_streaming_duration": 0,
                "total_streaming_duration_limit": -1,
                "monthly_streaming_duration": 0,
                "monthly_streaming_duration_limit": -1,
                "daily_streaming_duration": 0,
                "daily_streaming_duration_limit": -1,
                "daily_reset_at": null,
                "monthly_reset_at": null
            }
        }
    }
}

こちらです：

  • 顧客ID = data->access->customer_id (CUSTOMER_ID)

  • アクセストークン = data->access->access_token (ACCESS_TOKEN)

  • daily_reset_at, monthly_reset_at — null 許容の日付

また、個別の顧客の制限と統計情報も確認できます。

ユーザー管理

ユーザー情報

ページネーションを使用して、すべてのユーザーに関する情報を取得できます。

モデル customers で GET リクエストを使用します

curl -X GET "https://music-api.mubert.com/api/v3/service/customers" \
-H "company-id: COMPANY_ID" \
-H "license-token: LICENSE_TOKEN"

レスポンスには顧客モデルの一覧が含まれています。

すべてのデータを表示するには、ページネーションを使用してください。

curl -L -X GET "https://music-api.mubert.com/api/v3/service/customers?limit=10&offset=2" \
-H "company-id: COMPANY_ID" \
-H "license-token: LICENSE_TOKEN"

彼のカスタムIDまたは顧客IDを使用して、特定の顧客に関する情報を取得することもできます。例えば、次のように:

curl -X GET "https://music-api.mubert.com/api/v3/service/customers/CUSTOMER_ID" \
-H "company-id: COMPANY_ID" \
-H "license-token: LICENSE_TOKEN"

または

curl -X GET "https://music-api.mubert.com/api/v3/service/customers/custom-id/YOUR_CUSTOM_ID" \
-H "company-id: COMPANY_ID" \
-H "license-token: LICENSE_TOKEN"

回答には顧客モデルも含まれています。

ユーザーの削除

モデル customers で DELETE リクエストを使用してください

curl -X DELETE "https://music-api.mubert.com/api/v3/service/customers/CUSTOMER_ID" \
-H "company-id: COMPANY_ID" \
-H "license-token: LICENSE_TOKEN"

成功した場合は、204 No Content レスポンスを返します。

チャンネル一覧

ユーザー情報

ストリーミングとトラック生成の両方で、音楽チャンネルを選択する必要があります。

モデル playlists で GET を使用して、利用可能なすべてのカテゴリ、グループ、チャンネル、およびそれらのプレイリストインデックスの一覧を取得します。

curl -X GET "https://music-api.mubert.com/api/v3/public/playlists" \ 
-H "customer-id: CUSTOMER_ID" \ 
-H "access-token: ACCESS_TOKEN"

応答 200 OK

{
    "data": [
        {
            "playlist_index": "3.0.0",
            "category": "穏やか",
            "group": "アンビエント",
            "channel": "瞑想",
            "params": [
                {
                    "bpm": {
                        "gt": 45,
                        "lt": 83
                    },
                    "keys": [
                        "Cm",
                        "C",
                        "C#m",
                        "C#",
                        "Dm",
                        "D",
                        "D#m",
                        "D#",
                        "Em",
                        "E",
                        "Fm",
                        "F",
                        "F#m",
                        "F#",
                        "Gm",
                        "G",
                        "G#m",
                        "G#",
                        "Am",
                        "A",
                        "A#m",
                        "A#",
                        "Bm",
                        "B"
                    ]
                }
            ]
        },
        {
            "playlist_index": "3.0.1",
            "category": "穏やか",
            "group": "アンビエント",
            "channel": "オーム",
            "params": [...]
        },
        {
            "playlist_index": "3.0.2",
            "category": "穏やか",
            "group": "アンビエント",
            "channel": "禅",
            "params": [...]
        },
        .
        .
        .
}

ここではBPMの範囲とキーの一覧も確認できます。これらの値はトラック生成に利用できます。

ご注意ください。bpmパラメータには、特定のカテゴリで生成できる範囲があります。

gt は「より大きい」を意味し、lt は「より小さい」を意味します。

音楽ストリーミング

ストリーミング機能を使用する前に、契約上で有効になっていることを確認してください。また、ライセンス情報でも確認できます。ストリーミングへのリンクを取得するには、以下のリクエストを使用してください

リクエスト

curl -X GET "https://music-api.mubert.com/api/v3/public/streaming/get-link" \
-H "Content-Type: application/json" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN" \
-d "{
  \"playlist_index\": \"1.0.0\",
  \"bitrate\": 320,
  \"intensity\": \"medium\",
  \"type\": \"http\"
}"

レスポンス 200 OK

{
    "data": {
        "link": "https://stream.mubert.com/b2b/v3?customer_id=CUSTOMER_ID&access_token=ACCESS_TOKEN&playlist=1.0.0&bitrate=320&intensity=medium"
    }
}

パラメータ

  • playlist_index（必須）— チャンネルのインデックス

  • bitrate（任意）— kbpsで測定される音質

  • intensity（任意）— 編成の複雑さ。同時に演奏される楽器が少ないか多いか

  • type（任意）— ストリーミングプロトコルの種類

bitrate の可能な値: 32, 96, 128, 192, 256, 320

intensity の可能な値: low, medium, high

type の可能な値: http, webrtc

オプションのパラメータが省略されているか、または値が正しくない場合は、デフォルトのパラメータが bitrate=128、intensity=high、および type=http で適用されます。

gt は「より大きい」を意味し、lt は「より小さい」を意味します。

ループモード

最新の音楽作品の最後の部分をループするには（またはループモードをオフにするには）、set-loop-state URL を使用します。

パラメータ

  • loop（必須）— 指定可能な値: off, on

  • time（オプション）— UX を改善するため、現在のストリーム再生時間（セッション開始からの秒数）と同じ値に設定します

リクエスト

curl -X POST "https://music-api.mubert.com/api/v3/public/streaming/set-loop-state" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d "{
  \"loop\": \"on\",
  \"time\": 0
}"

応答

成功した場合は 204 No content を返します。

強度

set-intensity のURLを使うと、アレンジの複雑さを変更できます。各プリセットは、同時に演奏される楽器の数が少ないものから多いものまであります。強度は、ストリームを途切れさせることなくシームレスに変化します。

強度の可能な値: low, medium, high

リクエスト

curl -X POST "https://music-api.mubert.com/api/v3/public/streaming/set-intensity" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d "{
  \"intensity\": \"medium\"
}"

応答

成功した場合は 204 No content を返します。

生成の再開

ストリームを再起動して、同じ url で別のトラック（メロディ）が再生され始めるようにするには、POST メソッドと streaming/restart を使用します。

リクエスト

curl -X POST "https://music-api.mubert.com/api/v3/public/streaming/restart" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN"

応答

成功した場合は 204 No content を返します。

トラック生成

トラック生成機能を使い始める前に、契約内容で有効になっていることを確認してください。また、ライセンス情報でも確認できます。

このAPIを使えば、リクエストに応じてカスタムトラックを作成できます。各トラックはあなただけのオリジナル楽曲で、特別なリンクからダウンロードできます。

トラックを操作するには、モデル tracks を使用します。

トラックを作成

選択した特性のセットでトラックを作成するには、POST を使用します。

リクエスト

curl -X POST "https://music-api.mubert.com/api/v3/public/tracks" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d "{
    \"playlist_index\": \"1.0.0\",
    \"duration\": 60,
    \"bitrate\": 128,
    \"format\": \"wav\",
    \"intensity\": \"high\",
    \"mode\": \"track\"
}"

パラメータ

  • playlist_index（必須）- チャンネルインデックス

  • duration（必須）- トラックの長さ（秒）

  • format（任意）- mp3 または wav

  • bitrate（任意）- kbpsで測定される音質

  • intensity（任意）- 編成の複雑さ。同時に演奏される楽器の数が少ないか多いか

  • mode（任意）— 構成タイプ（track, loop, jingle, mix）

bitrate の可能な値: 32, 96, 128, 192, 256, 320

intensity の可能な値: low, medium, high

オプションのパラメータが省略されるか、誤った値が含まれている場合は、format=mp3、bitrate=128、intensity=high、mode=track のデフォルトパラメータが適用されます。

track - は、イントロ、ドロップ、ブレイク、アウトロを備えた共通の構成を持つトラックを意味します

loop - は、ループ再生できるトラックを指します

jingle - は、40秒までの音楽コンテンツに最適です。これは、固定され論理的な構成を持つ短い完成トラックです

mix - はDJの作業を模倣したもので、トラックが次々と流れ、滑らかにブレンドされます

playlist_index は「0.0.0」形式の汎用チャンネルインデックスで、category_id.group_id.channel_id で構成されます。複数のチャンネルをまとめるには、後ろの桁を省略します。

例えば: playlist=0.0 は「Calm」グループ内のすべてのチャンネルを再生し、playlist=0 は「Moods」カテゴリ全体を再生します。

応答

{
    "data": {
        "id": "TRACK_ID",
        "session_id": "SESSION_ID",
        "playlist_index": "1.0.0",
        "prompt": null,
        "bitrate": 128,
        "duration": 61,
        "intensity": "高",
        "mode": "トラック",
        "key": null,
        "bpm": null,
        "generations": [
            {
                "session_id": "GENERATION_SESSION_ID",
                "format": "mp3",
                "bitrate": 128,
                "status": "処理中",
                "generated_at": null,
                "expired_at": null,
                "created_at": "2025-01-01T00:00:00.000000Z",
                "url": null
            }
        ]
    }
}

こちら:

  • prompt, key, bpm, url — NULL可能な文字列

  • generated_at, expired_at — NULL可能な日付

トラックが作成されているかを確認するには、tracks モデルを TRACK_ID とともに使用します。次のようにします:

リクエスト

curl -X GET "https://music-api.mubert.com/api/v3/public/tracks/TRACK_ID" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN"

または、ライセンスに webhook を追加して、完了時にメッセージを受け取ることもできます。

テキスト-2-ミュージック

テキストプロンプトと選択した特徴のセットを使って、トラックを作成できます。この方法は前の方法に似ていますが、チャンネルを選ぶ代わりに、テキストメッセージを送信します。それはタグベースを持つトランスフォーマーニューラルネットワークに送られ、対応する音のセットが自動的に選択されます。その後、私たちのコンポーザーエンジンがトラックを作成し、ファイルをあなたに返します。

ご利用を開始する前に、契約同意書で有効になっていることを確認してください。

リクエスト

curl -X POST "https://music-api.mubert.com/api/v3/public/tracks" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d "{
    \"prompt\": \"YOUR_TEXT_PROMPT\",
    \"duration\": 60,
    \"bitrate\": 128,
    \"mode\": \"track\",
    \"intensity\": \"medium\",
    \"format\": \"mp3\"
}"

パラメータ

  • prompt（必須）—英語で入力するテキストプロンプト、最大200文字

  • duration（必須）—トラックの長さ（秒）

  • format（任意）— mp3 または wav

  • bitrate（任意）— kbps で測定される音質

  • intensity（任意）— 編曲の複雑さ。同時に演奏される楽器の数が少ないか多いか

  • mode（任意）— 作曲タイプ（track、loop）

bitrate の可能な値: 32, 96, 128, 192, 256, 320

intensity の可能な値: low, medium, high

prompt — ユーザー入力やその他の接続された入力（言語モデル、画像からテキストへの変換、ゲームメカニクスなど）から受け取ることができるテキストプロンプト

track — イントロ、ドロップ、ブレイク、アウトロからなる共通構成のトラックを意味します

loop — ループ可能なトラックを表します

オプションのパラメータが省略された場合、または値が正しくない場合は、format=mp3、bitrate=128、intensity=high、mode=track を使用したデフォルトのパラメータが適用されます

応答

成功した場合は 204 No content を返します。

強度

set-intensity のURLを使うと、アレンジの複雑さを変更できます。各プリセットは、同時に演奏される楽器の数が少ないものから多いものまであります。強度は、ストリームを途切れさせることなくシームレスに変化します。

強度の可能な値: low, medium, high

リクエスト

curl -X POST "https://music-api.mubert.com/api/v3/public/streaming/set-intensity" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d "{
  \"intensity\": \"medium\"
}"

応答

成功した場合は 204 No content を返します。

生成の再開

ストリームを再起動して、同じ url で別のトラック（メロディ）が再生され始めるようにするには、POST メソッドと streaming/restart を使用します。

リクエスト

curl -X POST "https://music-api.mubert.com/api/v3/public/streaming/restart" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN"

応答

成功した場合は 204 No content を返します。

画像から音楽へ

画像を使ってトラックを作成できます。使用を始める前に、契約内容に基づいて有効になっていることを確認してください。

リクエスト

curl -X POST "https://music-api.mubert.com/api/v3/public/tracks" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN" \
-F "image=@\"/filepath\"" \
-F "duration=\"60\"" \
-F "bitrate=\"128\"" \
-F "mode=\"track\"" \
-F "intensity=\"medium\"" \
-F "format=\"mp3\""

パラメータ

  • image（必須）— JPEG/PNG 形式の画像、最大 10 MB

  • duration（必須）— トラックの長さ（秒）

  • format（任意）— mp3 または wav

  • bitrate（任意）— kbps で測定される音質

  • intensity（任意）— アレンジの複雑さ。同時に演奏される楽器の数が少ないか多いか

  • mode（任意）— 作曲タイプ（track、loop）

bitrate の可能な値: 32, 96, 128, 192, 256, 320

intensity の可能な値: low, medium, high

track — イントロ、ドロップ、ブレイク、アウトロを含む一般的な構成のトラックを意味します

loop — ループ再生できるトラックを表します

オプションのパラメータが省略されたり、誤った値が含まれている場合は、format=mp3、bitrate=128、intensity=high、mode=track のデフォルトパラメータが適用されます

BPM/キー生成

playlist_index の生成パラメータに bpm と key を追加できます。

リクエスト

curl -X POST "https://music-api.mubert.com/api/v3/public/tracks" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d "{
    \"playlist_index\": \"6.1.4\",
    \"duration\": 60,
    \"bitrate\": 320,
    \"format\": \"mp3\",
    \"intensity\": \"high\",
    \"mode\": \"track\",
    \"bpm\":112,
    \"key\":\"D\"
}"

応答

成功すると track モデルで 200 OK を返します。

類似を生成

既存のトラックに似たトラックを生成できます。まったく同じものではありませんが、似ています。

POST で https://music-api.mubert.com/api/v3/public/tracks/TRACK_ID/similar を使用してください

リクエスト

curl -L -X POST "https://music-api.mubert.com/api/v3/public/tracks/TRACK_ID/similar" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d "{
    \"duration\": 90,
    \"bitrate\": 192,
    \"format\": \"mp3\",
    \"intensity\": \"high\",
    \"mode\": \"track\"
}"

トラック編集

既存のトラックの一部のパラメーターを変更できます。

リクエスト

curl -X POST "https://music-api.mubert.com/api/v3/public/tracks/TRACK_ID/edit" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d "{
    \"duration\": 90,
    \"bitrate\": 256,
    \"format\": \"mp3\",
    \"intensity\": \"high\"
}"

応答 200 OK

{
    "data": {
        "id": "TRACK_ID",
        "session_id": "SESSION_ID",
        "playlist_index": null,
        "prompt": null,
        "duration": 90,
        "intensity": "高",
        "mode": "トラック",
        "key": null,
        "bpm": null,
        "generations": [
            {
                "session_id": "GENERATION_SESSION_ID",
                "format": "mp3",
                "bitrate": 256,
                "status": "処理中",
                "generated_at": null,
                "expired_at": null,
                "created_at": "2025-01-01T00:00:00.000000Z",
                "url": null
            }
        ]
    }
}

また、トラックの一部を置き換えることもできます。各トラックは楽器で構成されています。トラックには次のような楽器が含まれる場合があります：

ドラムス, パーカッション, ハット, クラップ, ベース, ミッド, リード, エフェクト, ボーカル, パッド, ライザー, インパクト

これらの楽器は、次のようなステムに組み合わせることができます

つまり、これらのステムには次の楽器が含まれています:

  • DRUMS には DRUMS、PERCS、HATS、CLAPS が含まれます

  • BASS には BASS が含まれます

  • LEADS には MIDS、LEADS、PADS が含まれます

  • VOCALS には VOCALS が含まれます

  • FX には FX、RISER、IMPACT が含まれます

器具とステムの両方を交換できます。器具を交換するには：

楽器を置き換える:

curl -X POST "https://music-api.mubert.com/api/v3/public/tracks/TRACK_ID/edit" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d "{
    \"replace_instruments\":[\"HATS\"]
}"

ステムを交換:

curl -X POST "https://music-api.mubert.com/api/v3/public/tracks/TRACK_ID/edit" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d "{
    \"replace_stems\":[\"DRUMS\"]
}"

楽器を削除：

curl -X POST "https://music-api.mubert.com/api/v3/public/tracks/TRACK_ID/edit" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d "{
    \"delete_instruments\":[\"PADS\", \"PERCS\"]
}"

茎を削除:

curl -X POST "https://music-api.mubert.com/api/v3/public/tracks/TRACK_ID/edit" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d "{
    \"delete_stems\":[\"BASS\", \"FX\"]
}"

これらのリクエストはすべてtrackモデルを受け取ります。

トラック一覧

トラック一覧を取得するには、GET を tracks モデルで使用してください。

curl -X GET "https://music-api.mubert.com/api/v3/public/tracks" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN"

レスポンスにはトラックモデルの一覧が含まれています。

ページネーションを使用して、すべてのデータを表示してください。

特定のトラックに関する情報も確認できます。

curl -X GET "https://music-api.mubert.com/api/v3/public/tracks/TRACK_ID" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN"

応答にはトラックモデルが含まれています。

トラックストア

トラック保存機能を使うと、事前生成されたトラックを格納するバッファを作成できます。長い待ち時間なしで、指定した長さ、モード、形式のユニークなトラックを取得したい場合に最適です。私たちはクラウドバケットを作成し、ファイルの受信を高速化するための専用ジェネレーターをセットアップします。Mubert は、1組のパラメータで複数のトラックを生成してバケットに保存します。これらのファイルのいずれかを使用すると、バッファを補充するための類似したトラック生成が開始されます。バケット内のファイル数は、サービスの平均負荷によって決まります。これを計算するために、次のパラメータ一覧も必要です: モード、長さ、ビットレート、強度、形式。バケット作成を続けるには、これらのパラメータの値を選択し、担当マネージャーにメールを送信してください。また、事前生成したいプレイリストを選択することもできます。デフォルトではすべてのチャンネルを使用します。

track のリクエストパラメータが store のパラメータと一致すると、track store から track を自動的に取得できます。track store の利用を開始する前に、契約内容で有効になっていることを確認してください。

Mubert 音楽ライブラリ

当社の音楽エディターが厳選した、Mubertの人工知能を使って制作された12,000曲以上のトラックからなるライブラリをご用意しました。

パラメータ

音楽ライブラリの統計情報と、トラックを絞り込むために使用できるパラメータを確認するには、GET メソッドを使用します。

リクエスト

curl -X GET "https://music-api.mubert.com/api/v3/public/music-library/params" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN"

応答

[
    {
        "param": "activities",
        "values": [
            {
                "value": "ミニマル 170",
                "tracks_count": 80
            },
            {
                "value": "ラブリー",
                "tracks_count": 40
            },
            {
                "value": "瞑想",
                "tracks_count": 108
            },
            .
            .
            .
        ]
    },
    {
        "param": "bpm",
        "values": [
            {
                "value": "100",
                "tracks_count": 684
            },
            {
                "value": "105",
                "tracks_count": 13
            },
            {
                "value": "108",
                "tracks_count": 186
            },
            .
            .
            .
        ]
    },
    .
    .
    .
]

特定のパラメータに関する情報も取得できます。たとえば: BPM 120

curl -X GET "https://music-api.mubert.com/api/v3/public/music-library/params?bpm=120" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN"

応答

{
        "param": "テーマ",
        "values": [
            {
                "value": "コーポレート",
                "tracks_count": 315
            },
            {
                "value": "ポッドキャスト",
                "tracks_count": 12
            },
            .
            .
            .
        ]
    },
    {
        "param": "ジャンル",
        "values": [
            {
                "value": "ニュー・ディスコ",
                "tracks_count": 138
            },
            {
                "value": "フォーク",
                "tracks_count": 27
            },
            .
            .
            .
        ]
    },

これは、テーマ「Сorporate」で BPM 120 のトラックが 315 曲、テーマ「Podcast」で 12 曲、ジャンル「Nu Disco」で 138 曲、ジャンル「Folk」で 27 曲見つけられることを意味します。

複数のパラメータを指定すると、それらに論理 AND が適用されます。

リクエスト

curl -X GET "https://music-api.mubert.com/api/v3/public/music-library/params?bpm=120&genres=Nu%20Disco" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN"

応答

[
    {
        "param": "bpm",
        "values": [
            {
                "value": "120",
                "tracks_count": 138
            }
        ]
    },
    {
        "param": "genres",
        "values": [
            {
                "value": "ニュー・ディスコ",
                "tracks_count": 138
            },
            {
                "value": "EDM",
                "tracks_count": 3
            },
            {
                "value": "トロピカル・ハウス",
                "tracks_count": 11
            },
            .
            .
            .
        ]
    },
    .
    .
    .
    {
        "param": "duration",
        "values": [
            {
                "value": "15",
                "tracks_count": 7
            },
            {
                "value": "60",
                "tracks_count": 18
            },
            {
                "value": "120",
                "tracks_count": 11
            },
            {
                "value": "165",
                "tracks_count": 14
            },
            {
                "value": "180",
                "tracks_count": 64
            },
            {
                "value": "420",
                "tracks_count": 12
            },
            {
                "value": "1500",
                "tracks_count": 12
            }
        ]
    }
]

応答では、リクエスト BPM 120 AND Genre Nu Disco に対応する各再生時間ごとのトラック数も確認できます

トラック

GETメソッドを使用してトラックの一覧を受信します。

リクエスト

curl -X GET "https://music-api.mubert.com/api/v3/public/music-library/tracks" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN"

応答

{
    "data": [
        {
            "id": "TRACK_ID",
            "session_id": "SESSION_ID",
            "playlist_index": "0.6.1",
            "prompt": null,
            "duration": 120,
            "intensity": "高",
            "mode": "トラック",
            "bpm": 100,
            "key": "D#m",
            "generations": [
                {
                    "session_id": "GENERATION_SESSION_ID",
                    "format": "mp3",
                    "bitrate": 320,
                    "status": "完了",
                    "generated_at": "2025-02-01T00:00:00.000000Z",
                    "created_at": "2025-02-01T00:00:00.000000Z",
                    "url": "YOUR_TRACK_LINK"
                }
            ]
        },
        .
        .
        .
    ],
    "meta": {
        "offset": 0,
        "limit": 100,
        "total": 10075
    }
}

レスポンスにはトラックモデルの一覧が含まれています。すべてのデータを見るにはページネーションを使用してください。また、1つ以上のパラメータを使用してトラックを絞り込み、最適なものを見つけることもできます。例えば: BPM 120 AND Genre Nu Disco AND Duraton 180

リクエスト

curl -X GET "https://music-api.mubert.com/api/v3/public/music-library/tracks?bpm=120&genres=Nu%20Disco&duration=180" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN"

応答

{
    "data": [
        {
            "id": "TRACK_ID",
            "session_id": "SESSION_ID",
            "playlist_index": null,
            "prompt": null,
            "duration": 180,
            "intensity": "高",
            "mode": "トラック",
            "bpm": 120,
            "key": "G",
            "generations": [
                {
                    "session_id": "GENERATION_SESSION_ID",
                    "format": "mp3",
                    "bitrate": 320,
                    "status": "完了",
                    "generated_at": "2022-02-01T00:08:00.000000Z",
                    "created_at": "2022-02-01T00:00:00.000000Z",
                    "url": "YOUR_TRACK_LINK"
                }
            ]
        },
    ],
     "meta": {
        "offset": 0,
        "limit": 100,
        "total": 64
    }
}

レスポンスにはトラックモデルの一覧も含まれます。すべてのデータを表示するにはページネーションを使用してください。

スワッガー

より技術的な情報については、swagger を使用できます: https://music-api.mubert.com/api/v3/swagger

価格

透明で柔軟

透明で柔軟

月額49ドルから試してみてください

トライアルプラン

トライアルプラン

顧客開発とテストのために

199ドル

199ドル

毎月

今すぐ始めよう

100世代／月

月に100ストリーミング分

含まれる機能:

100生成されたトラック

100ストリーミング分

テキスト-2-ミュージック

画像から音楽へ

高品質

返金不可

マネタイズされたコンテンツ

キュレーションライブラリ

サブライセンス

配布

専用サポート

人気

スタートアッププラン

小さな製品のために

199ドル

199ドル

毎月

今すぐ始めよう

月あたり5,000世代

月あたり5,000分のストリーミング

含まれる機能:

All Build Features

5,000生成されたトラック

5,000 ストリーミング分

12,000以上のキュレーションライブラリ

ウェブフック

ロスレス品質

マネタイズされたコンテンツ

返金不可

サブライセンス

配布

専用サポート

スタートアッププラン

大規模なアプリのために

199ドル

199ドル

毎月

今すぐ始めよう

月間30,000世代

月に30,000分のストリーミング

含まれる機能:

すべてのスタートアップ機能

30,000生成されたトラック

30,000のストリーミング時間

返金不可

サブライセンス

専用サポート

配布

カスタムプラン

特別なリクエストがある場合は、[email protected] にテキストを送信してください。

可能な機能:

ボーカル

カスタム音楽ステム

オーディオブランディング

音楽のスケジュール

広告

トライアルプラン

トライアルプラン

顧客開発とテストのために

199ドル

199ドル

毎月

今すぐ始めよう

100世代／月

月に100ストリーミング分

含まれる機能:

100生成されたトラック

100ストリーミング分

テキスト-2-ミュージック

画像から音楽へ

高品質

返金不可

マネタイズされたコンテンツ

キュレーションライブラリ

サブライセンス

配布

専用サポート

人気

スタートアッププラン

小さな製品のために

199ドル

199ドル

毎月

今すぐ始めよう

月あたり5,000世代

月あたり5,000分のストリーミング

含まれる機能:

All Build Features

5,000生成されたトラック

5,000 ストリーミング分

12,000以上のキュレーションライブラリ

ウェブフック

ロスレス品質

マネタイズされたコンテンツ

返金不可

サブライセンス

配布

専用サポート

スタートアッププラン

大規模なアプリのために

199ドル

199ドル

毎月

今すぐ始めよう

月間30,000世代

月に30,000分のストリーミング

含まれる機能:

すべてのスタートアップ機能

30,000生成されたトラック

30,000のストリーミング時間

返金不可

サブライセンス

専用サポート

配布

カスタムプラン

特別なリクエストがある場合は、[email protected] にテキストを送信してください。

可能な機能:

ボーカル

カスタム音楽ステム

オーディオブランディング

音楽のスケジュール

広告

トライアルプラン

トライアルプラン

顧客開発とテストのために

199ドル

199ドル

毎月

今すぐ始めよう

100世代／月

月に100ストリーミング分

含まれる機能:

100生成されたトラック

100ストリーミング分

テキスト-2-ミュージック

画像から音楽へ

高品質

返金不可

マネタイズされたコンテンツ

キュレーションライブラリ

サブライセンス

配布

専用サポート

人気

スタートアッププラン

小さな製品のために

199ドル

199ドル

毎月

今すぐ始めよう

月あたり5,000世代

月あたり5,000分のストリーミング

含まれる機能:

All Build Features

5,000生成されたトラック

5,000 ストリーミング分

12,000以上のキュレーションライブラリ

ウェブフック

ロスレス品質

マネタイズされたコンテンツ

返金不可

サブライセンス

配布

専用サポート

スタートアッププラン

大規模なアプリのために

199ドル

199ドル

毎月

今すぐ始めよう

月間30,000世代

月に30,000分のストリーミング

含まれる機能:

すべてのスタートアップ機能

30,000生成されたトラック

30,000のストリーミング時間

返金不可

サブライセンス

専用サポート

配布

カスタムプラン

特別なリクエストがある場合は、[email protected] にテキストを送信してください。

可能な機能:

ボーカル

カスタム音楽ステム

オーディオブランディング

音楽のスケジュール

広告

現在 配信中 — 動画にサウンドトラックを付けよう

現在 配信中 — 動画にサウンドトラックを付けよう

現在 配信中 — 動画にサウンドトラックを付けよう

現在 配信中 — 動画にサウンドトラックを付けよう

Mubert Render

Render

価格

ライセンス

ユースケース

仕組み

Mubert API

API

価格

ドキュメント

ユースケース

ツール

Mubert フューズ

Mubert フューズ

YouTube著作権チェッカー

DMCA Twitchチェッカー

Instagramリールチェッカー

TikTokサウンドチェッカー

その他の商品

ストリーマー向けのMubert

ビジネス向けMubert

について

ブログ

よくある質問

について

連絡先

200以上のムードとテーマで音楽を生成します。Mubert API をアプリ、AIエージェント、ゲーム、およびライブストリームに統合します。ロイヤリティフリーの音楽。

Mubert株式会社
8 The Green, Dover
デラウェア州、米国 19901​
[email protected]

Japanese

© 2016 – 2026、Mubert Inc.の全ての音楽は *.mubert.com ドメインで放送されており、Mubert® Incが所有する人工知能（アルゴリズム、ソフトウェア、プログラム）によって生成（作成、作曲、録音）されています。この音楽は個人使用のみMubert® Incからライセンスが提供されます。全ての権利は保護されています。この音楽の公共の複製、録音、配布は禁止されています。

プライバシーポリシー

利用規約

DMCAポリシー

Mubert Render

Render

価格

ライセンス

ユースケース

仕組み

Mubert API

API

価格

ドキュメント

ユースケース

ツール

Mubert フューズ

Mubert フューズ

YouTube著作権チェッカー

DMCA Twitchチェッカー

Instagramリールチェッカー

TikTokサウンドチェッカー

その他の商品

ストリーマー向けのMubert

ビジネス向けMubert

について

ブログ

よくある質問

について

連絡先

200以上のムードとテーマで音楽を生成します。Mubert API をアプリ、AIエージェント、ゲーム、およびライブストリームに統合します。ロイヤリティフリーの音楽。

Mubert株式会社
8 The Green, Dover
デラウェア州、米国 19901​
[email protected]

Japanese

© 2016 – 2026、Mubert Inc.の全ての音楽は *.mubert.com ドメインで放送されており、Mubert® Incが所有する人工知能（アルゴリズム、ソフトウェア、プログラム）によって生成（作成、作曲、録音）されています。この音楽は個人使用のみMubert® Incからライセンスが提供されます。全ての権利は保護されています。この音楽の公共の複製、録音、配布は禁止されています。

プライバシーポリシー

利用規約

DMCAポリシー

Mubert Render

Render

価格

ライセンス

ユースケース

仕組み

Mubert API

API

価格

ドキュメント

ユースケース

ツール

Mubert フューズ

Mubert フューズ

YouTube著作権チェッカー

DMCA Twitchチェッカー

Instagramリールチェッカー

TikTokサウンドチェッカー

その他の商品

ストリーマー向けのMubert

ビジネス向けMubert

について

ブログ

よくある質問

について

連絡先

200以上のムードとテーマで音楽を生成します。Mubert API をアプリ、AIエージェント、ゲーム、およびライブストリームに統合します。ロイヤリティフリーの音楽。

Mubert株式会社
8 The Green, Dover
デラウェア州、米国 19901​
[email protected]

Japanese

© 2016 – 2026、Mubert Inc.の全ての音楽は *.mubert.com ドメインで放送されており、Mubert® Incが所有する人工知能（アルゴリズム、ソフトウェア、プログラム）によって生成（作成、作曲、録音）されています。この音楽は個人使用のみMubert® Incからライセンスが提供されます。全ての権利は保護されています。この音楽の公共の複製、録音、配布は禁止されています。

プライバシーポリシー

利用規約

DMCAポリシー