音楽APIとCLI

アカウントを接続

1. アカウントを作成 し、メールアドレスを確認してください。
2. 設定を開き、APIキーを作成してください。 APIキー
3. キーはサーバーまたはシークレットマネージャーに保管してください。Authorizationヘッダーとして送信し、URLやフロントエンドコードには決して含めないでください。

キーは90日後に期限切れになります。5つのアクティブなキーを持つことができ、設定でキーを即座に失効させることができます。読み取り専用キーでは曲を生成できません。

curl https://mcp.wordsintomusic.com/v1/account \
  -H "Authorization: Bearer $WIM_API_KEY"

曲の準備、開始、確認

まず、クレジットを消費せずにブリーフを準備します。その準備を開始すると、既存のソングクレジットを1つ消費します。再試行時には同じリクエストIDを保持してください。タイムアウトによって別の曲が開始されることはありません。

{
  "requestId": "my-first-song-20261021",
  "input": {
    "mode": "idea",
    "idea": "新しい街で再出発する希望に満ちた歌",
    "direction": "温かいアコースティックポップ、安定したドラム、優しいボーカル",
    "language": "ja",
    "duration": 120
  },
  "uiLocale": "ja"
}

このJSONをPOST /v1/songs/prepareに送信します。次に、そのpreparedRequestIdをPOST /v1/songs/startに送信します。GET /v1/jobs/{jobId}を少なくとも15秒間隔で確認してください。準備ができたら、返されたプライベートライブラリリンクを開いて聴いたりダウンロードしたりできます。

対応する曲の言語は、英語、スペイン語、ドイツ語、フランス語、ブラジルポルトガル語、イタリア語、オランダ語、ポーランド語、スウェーデン語、日本語、韓国語です。長さは60～180秒で指定してください。自分の歌詞を使う場合は歌詞モードを、ボーカルなしの音楽には instrumental: true を使用してください。

APIエンドポイント

APIのベースURLは https://mcp.wordsintomusic.com/v1. OpenAPI仕様をダウンロードする リクエストフィールド、制限、権限、レスポンス形式について

コマンドラインを使用する

npm install -g words-into-music-cli
wim login --key-stdin
wim account
wim prepare --file brief.json
wim start PREPARED_REQUEST_ID --confirm
wim job JOB_ID
wim songs --limit 10

Node.js 22以降を使用してください。標準入力でログインキーを渡すか、シークレットマネージャーからWIM_API_KEYを提供してください。コマンド引数やシェル履歴に入れないでください。詳細については `wim --help` を実行してください。

クレジット、制限、プライバシー

ソングクレジットが必要な場合、APIはHTTP 402を返します。GET /v1/accountからオファーを選択し、確認済みの選択肢でPOST /v1/billing/checkoutを実行してください。別のウェブサイトにログインすることなくStripeで支払えます。支払いが確認された後、残高を確認し、元のpreparedRequestIdを再試行してください。

APIアクセスとCLIには個別のサブスクリプションはありません。レコーディングの生成には、既存のソングアローワンスが使用され、アプリと同じアカウント制限が適用されます。APIが自動的に課金することはありません。

キー所有者の曲のみ読み取ることができます。歌詞はリクエストされた場合にのみ返されます。キーを失効させると新しいAPI呼び出しは停止しますが、すでに受け付けられた曲は処理を続行します。

ゲートウェイは、IPアドレスごとに1分あたり最大30件のAPIリクエストを許可します。APIおよびMCP呼び出しは、1分あたり120リクエストのアカウント制限も共有します。429レスポンスではRetry-Afterヘッダーを尊重してください。成功した準備IDは、期限切れ後30日間、再試行保護のために利用可能です。

アシスタント接続には、弊社の MCPセットアップガイド. アカウントの許容量については、以下を参照してください 料金.