ACE Music API で AI の曲を生成する方法

22分で読めます • 2026年11月14日

目次

  1. はじめに
  2. モデルと API でできること
  3. 料金
  4. curl で曲を生成する方法
    1. ACE Music のアカウントを追加する
    2. プロンプトから曲を作る
    3. 返ってくる内容
    4. 同期、非同期、Webhook
  5. 自作の歌詞を歌わせる
  6. ACE-Step でテンポ、キー、拍子を指定する
  7. カバー、リミックス、編集
    1. 2曲または3曲をマッシュアップする
  8. 手持ちの音声や画像をもとに曲を作る
  9. ステム、ダウンロード、楽譜
    1. 曲をステムに分ける
    2. MP3、WAV、MIDI、MusicXML をダウンロードする
    3. 楽譜を読み取る
  10. ライブラリ
  11. 複数の ACE Music アカウント
  12. Claude、ChatGPT、Cursor から使う（MCP）
  13. スクリプトで一括生成する
  14. 例
    1. 画像から作った曲
    2. プロンプトから作った曲
    3. 自作の歌詞で作った曲
    4. テンポ、キー、拍子を指定した ACE-Step
    5. カバー、リミックス、編集の例
    6. マッシュアップ
    7. 手持ちの音声と画像
    8. 「Paper Lanterns」のステム
  15. よくある質問
  16. おわりに

はじめに

useapi.net の ACE Music API は、REST の呼び出し1回で、ACE Music の完成した曲を2曲返します。ボーカル、歌詞、タイトル、カバーアート付きで、作成にはすでにお持ちの ACE Music のサブスクリプションを使います。ACE Music v1 は Artificial Analysis のボーカル音楽リーダーボードで Suno v6 を抑えて1位です。ACE Music v1 と v1.1 には独自の公開 API がない（2026年11月時点）ため、コードから呼び出す方法は useapi.net だけです。オープンソースの ACE-Step v1.5 XL も同じ API で動き、Free プランを含むどの ACE Music のプランでもクレジットを消費しません。

このガイドでは、まず3つのモデルと1曲あたりの料金を説明し、curl で1曲を最初から最後まで作り、そのほかの機能を短い表でひととおり紹介します。最後の例は、このページのために作った18曲で、それぞれに作成したリクエストを添えています。どれも acemusic-api GitHub リポジトリのスクリプト（Node.js と Python）で作り、撮り直しも含めて Artist プランの117クレジットで済みました。useapi.net はサードパーティの API で、ACE Music やその開発元の Timedomain とは提携していません。

モデルと API でできること

どのリクエストも2曲を作り、model で作るモデルを選びます。

モデル model 用途 設定 1リクエストのクレジット 実測の所要時間
ACE Music v1 acemusic-v1（デフォルト） ボーカル1位のモデル。プロンプトや自作の歌詞から、歌入りまたはインストの曲を作る duration 30〜600秒、negative、styleInfluence、WAV ダウンロード 4 46〜89秒
ACE Music v1.1 Preview acemusic-v1.1 先に楽譜を書くので、カバーやマッシュアップが原曲のメロディに沿う audioInfluence、styleInfluence 4 35〜83秒
ACE-Step v1.5 XL ace-step-1.5-xl ACE Studio と StepFun によるオープンソース。曲、リミックス、編集 bpm、key、timeSignature、duration 10〜240秒、negative、thinking。MP3 のみ 0 20〜55秒

これらのモデルでできること：

できること リクエスト 備考
プロンプトから曲を作る POST /music prompt スタイル、歌詞、タイトルは ACE Music が書く
自作の歌詞、インスト POST /music style、lyrics どの言語でも可
歌詞とスタイルの作成ツール POST /music/lyrics、/music/style クレジット不要
カバー、リミックス、編集、マッシュアップ POST /music mode アカウントのどの曲にも使える
手持ちの音声と画像 POST /files 新しい曲の参照として使う
ステム POST /music/stems Creator と Artist
ダウンロード、楽譜 GET /music/download、/music/score MP3 と楽譜はすべてのプラン、WAV、MIDI、MusicXML は Creator と Artist
ライブラリ、ジョブ、アカウント GET /music、/jobs、/accounts アカウントの全曲、実行中のジョブ、最新のクレジット残高
MCP サーバー /v1/acemusic/mcp AI アシスタント向けの15ツール

料金

ACE Music はリクエストごとに、お使いの ACE Music のプランから独自のクレジットを差し引きます。useapi.net が曲ごとに上乗せする料金はありません（2026年11月時点）。

リクエスト クレジット
ACE Music v1 または v1.1 で2曲 4
ステム、ボーカル + インスト 5、有料プラン
ステム、全パート 60、有料プラン
ACE-Step の曲の楽譜、初回の読み取り 1
ACE-Step v1.5 XL で2曲 0、すべてのプラン
歌詞とスタイルの作成ツール、アップロード、ダウンロード テストでは0

ACE Music のプランは、1日20クレジットの Free、月額 $9.90 で1,000クレジットの Creator、月額 $29 で2,500クレジットの Artist で、年払いならそれぞれ月額 $7.90 と $16.58 です。1曲はリクエストの半分なので、2クレジットです。API の概要にも同じ表があります。

プランごとの1曲の料金です。左ほど安くなります（1リクエストで2曲作るので、1曲はリクエストのクレジットの半分です。2026年11月時点）。

モデル Free
1日20 cr		 Artist $16.58/月
月2,500 cr、年払い		 Creator $7.90/月
月1,000 cr、年払い		 Creator $9.90/月
月1,000 cr		 Artist $29/月
月2,500 cr
ACE Music v1、v1.1
1曲		 $0 / 2 cr
1日10曲		 $0.013 / 2 cr
月1,250曲		 $0.016 / 2 cr
月500曲		 $0.020 / 2 cr
月500曲		 $0.023 / 2 cr
月1,250曲
ステム
ボーカル + インスト		 有料プラン $0.033 / 5 cr $0.040 / 5 cr $0.050 / 5 cr $0.058 / 5 cr
ステム
全パート		 有料プラン $0.40 / 60 cr $0.47 / 60 cr $0.59 / 60 cr $0.70 / 60 cr
ACE-Step の楽譜
初回の読み取り		 $0 / 1 cr $0.007 / 1 cr $0.008 / 1 cr $0.010 / 1 cr $0.012 / 1 cr
ACE-Step v1.5 XL
1曲		 $0 / 0 cr $0 / 0 cr $0 / 0 cr $0 / 0 cr $0 / 0 cr

コードからこれらのモデルを呼び出すほかの方法との比較です。

モデル useapi.net ほかの API
ACE Music v1、v1.1 Preview Artist の年払いで1曲 $0.013 から、Free プランの1日20クレジットなら $0 なし：ACE Music はこれらのモデルの公開 API を提供していない
ACE-Step v1.5 XL Free プランを含むすべての ACE Music のプランで $0 サードパーティの acestep.io の API で1曲約 $0.14。同社の月額 $49 の Studio プランが必要

Free プランを含むどの ACE Music のプランでも、ACE-Step v1.5 XL の曲はクレジットを消費しません。一方、サードパーティの acestep.io の API を使うには、同社の月額 $49 の Studio プランが必要です（月に約360曲、1曲あたり約 $0.14、2026年11月時点）。

API を使い始める

月額15ドルのサブスクリプション1つで、useapi.net のすべての API を使えます。トークン1つで、すべてのサービスに対応します。各サービスにご自身のアカウントを最大3つまで接続でき、REST API、負荷分散、ポーリングは useapi.net が担当します。アカウントを増やしたい場合は、サブスクリプションを1つ追加するごとに月額10ドルで、各サービスのアカウントが3つずつ増えます。

登録する — 月額15ドル 暗号資産で支払う

海外で使えるクレジットカードがない場合は、暗号資産で登録することもできます（暗号資産での支払いは返金できません）。料金とボリュームプランはサブスクリプションのページをご覧ください。Stripe でお支払いの場合、初回購入から14日以内で、成功した生成が50回未満であれば全額返金されます。すでに登録済みの場合は、新たに購入せず Stripe カスタマーポータルで数量を変更してください。

curl で曲を生成する方法

useapi.net の API トークン（useapi.net のセットアップを参照）と、メールアドレスとパスワードで使う ACE Music のアカウントが必要です。月額 $15 のサブスクリプション1つで、useapi.net のすべての API と3つの ACE Music アカウントを使えます。ACE Music の Free アカウントでもかまいません。1日20クレジットがもらえ、ACE-Step の曲にはクレジットが要りません。コマンドでは JSON を読むのに jq を使います。

ACE Music のアカウントを追加する

トークンを export し、アカウントを一度だけ追加します。API がサインインしてアカウントを読み取り、ACE Music がパスワードを受け入れた場合にだけ保存します。

export USEAPI_TOKEN="user:12345-..."
API=https://api.useapi.net/v1/acemusic

curl -s -X POST "$API/accounts" \
  -H "Authorization: Bearer $USEAPI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "email": "[email protected]", "password": "your-acemusic-password" }'

「Google で続行」や電話番号で作ったアカウントには、先にパスワードを設定する必要があります。ACE Music のセットアップをご覧ください。そこからアカウントを追加することもできます。

プロンプトから曲を作る

作りたい曲を自分の言葉で説明します。ACE Music がスタイル、歌詞、タイトルを書き、2曲を作ります。次のリクエストは、このページの最初の曲を作ったものそのままです。

curl -s -X POST "$API/music" \
  -H "Authorization: Bearer $USEAPI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A late-night neo-soul slow jam about two strangers sharing an umbrella at a bus stop in the rain and missing the last bus on purpose. Warm Rhodes piano, brushed drums, round upright bass, a smoky female lead with close three-part harmonies on the chorus.",
    "model": "acemusic-v1",
    "async": true
  }' | tee job.json | jq '{jobid, status, model}'

async: true を付けると、API はすぐに 201 とジョブを返します。プロンプトは最大2,000文字で、参照する曲を最大3曲、画像を最大3枚付けられます。手持ちの音声や画像をもとに曲を作るをご覧ください。

返ってくる内容

ACE Music が歌詞を書いている間、曲は planning で Untitled のままで、その後 queued、running になります。GET /jobs/jobid を10秒ほどおきにポーリングしてください。jobid には : と @ が含まれるので、URL エンコードします。

curl -s "$API/jobs/$(jq -r .jobid job.json | jq -Rr @uri)" \
  -H "Authorization: Bearer $USEAPI_TOKEN" | jq '{status, songs: [.songs[] | {title, status, duration, audioUrl}]}'

status が completed になると、各曲にリンクが入ります（以下の ID は架空のものです）。

{
  "jobid": "j1115003713275918262m-u12345-email:[email protected]:so_7c1d9e3a5b2f4806a4e1c9d3.so_8b4f2e6a1c9d47e5a3b7c0d2-bot:acemusic",
  "type": "music",
  "status": "completed",
  "email": "[email protected]",
  "created": "2026-11-15T00:37:13.275Z",
  "model": "acemusic-v1",
  "modelUsed": "acemusic-v1",
  "songs": [
    {
      "songId": "user:[email protected]:so_7c1d9e3a5b2f4806a4e1c9d3",
      "taskId": "so_7c1d9e3a5b2f4806a4e1c9d3",
      "status": "succeeded",
      "title": "Let the 44 Roll By",
      "model": "acemusic-v1",
      "style": "Late-night neo-soul slow jam with a laid-back 1990s and early 2000s pocket, 72 BPM. …",
      "lyrics": "[Intro - Warm Rhodes chords, brushed snare rim clicks, subtle rain on asphalt]\n\n[Verse 1 …]\nWater dripping off the canvas seam\n…",
      "instrumental": false,
      "duration": 277.19,
      "audioUrl": "https://acemusic.ai/data/so_7c1d9e3a5b2f4806a4e1c9d3.mp3",
      "playUrl": "https://….r2.cloudflarestorage.com/acemusic-data-prod/users/…/audio/202611/….mp3?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20261115T003902Z&X-Amz-Expires=3599&…",
      "playUrlExpires": "2026-11-15T01:39:01.000Z",
      "coverUrl": "https://acemusic.ai/data/so_7c1d9e3a5b2f4806a4e1c9d3-cover.jpg?v=1794703081642",
      "pageUrl": "https://acemusic.ai/song/r4k8w2n6p9tz",
      "created": "2026-11-15T00:37:13.300Z",
      "finished": "2026-11-15T00:38:42.208Z",
      "kind": "original",
      "score": false
    },
    { "songId": "user:[email protected]:so_8b4f2e6a1c9d47e5a3b7c0d2", "title": "Let the 44 Roll By", "duration": 253.99, "…": "…" }
  ],
  "completed": "2026-11-15T00:38:42.208Z"
}
  • audioUrl は曲の公開 MP3 リンクで、変わることはありません。playUrl は同じ MP3 への Web プレーヤー向けの直接リンクで、playUrlExpires まで（約1時間）有効です。Brave など一部のブラウザーは、audioUrl の裏にあるリダイレクトをブロックするためです。
  • songId は、カバー、マッシュアップ、ステム、ダウンロード、楽譜の各リクエストに渡す値です。曲がどのアカウントにあるかを示しているので、これらの呼び出しはそのアカウントで実行されます。
  • model はリクエストで指定したモデル、modelUsed は実際に動いたモデルです（マッシュアップを参照）。kind は original、cover、edit、mashup、upload のいずれかで、score は曲の楽譜がもうあるかどうかを示します。
  • ACE Music が作れなかった曲は status: "failed" になり、error に ACE Music の理由が入ります。クレジットが返ってきた場合は refunded: true になります。

こちらが、その2曲のうちの1曲目です。

ACE Music v1 —「Let the 44 Roll By」· 4:37 · 生成 89秒

同期、非同期、Webhook

送る内容 POST の応答 その後
async: true すぐに 201 とジョブ GET /jobs/jobid をポーリング
async なし 完成したジョブとともに 200。上と同じ JSON 応答から曲を読む。100秒たっても終わらないリクエストは 202 とジョブを返すので、それをポーリング
replyUrl と replyRef 同期でも非同期でも上と同じ 公開されたご自身の https の URL に、replyRef を含む完成したジョブが POST で1回届く

async なしで送った ACE-Step のリクエストは37秒で返り、Webhook は曲の完成から12秒後に届きました。ジョブは7日間読み取れ、開始から30分たっても実行中のジョブは 504 で失敗します。async-webhooks/ は3つの方法をすべて実行するスクリプトで、小さな Webhook 受信サーバーも付いています。

API 呼び出しを表示 
curl -s -X POST "$API/music" \
  -H "Authorization: Bearer $USEAPI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A dreamy lo-fi hip hop beat for studying late at night: dusty vinyl crackle, mellow Rhodes chords, a soft upright bass and rain on the window",
    "model": "ace-step-1.5-xl",
    "replyUrl": "https://your-server.example.com/acemusic-hook",
    "replyRef": "lofi-1"
  }' | jq '{status, songs: [.songs[] | {title, duration, audioUrl}]}'

自作の歌詞を歌わせる

prompt の代わりに style と lyrics を送ると、ACE Music があなたの歌詞をあなたのスタイルで歌います。

フィールド 役割 上限
style ジャンル、楽器、ムード、テンポ、ボーカル 1,000文字、ACE-Step では512文字
lyrics 歌詞。どの言語でも可。[Verse]、[Chorus]、[Bridge] のタグを使う 5,000文字、ACE-Step では2,000文字
title 曲のタイトル。省略すると ACE Music が付ける 80文字
instrumental true でボーカルなし。lyrics なしで style だけを送っても同じ  
duration 長さ（秒） ACE Music v1 では30〜600、ACE-Step では10〜240
negative 避けたいスタイル 200文字。ACE Music v1 と ACE-Step
styleInfluence スタイルにどれだけ厳密に従うか 0〜100、デフォルトは 80。ACE Music v1 と v1.1

これらのフィールドと prompt を一緒に送らないでください。API は 400 を返し、外すべき項目を示します。duration: 210 を指定したバラードは、210秒と209秒で返ってきました。インストとスペイン語の曲とあわせて、例に載せています。

歌詞がまだない場合は、POST /music/lyrics が依頼内容から歌詞とタイトルを書き、POST /music/style が短い言葉を完全なスタイルに広げます。私たちの依頼はそれぞれ6秒と4秒で返り、クレジットは消費されませんでした。スクリプト：custom-lyrics/

ACE-Step でテンポ、キー、拍子を指定する

ACE-Step v1.5 XL は、ACE Music のモデルにはない音楽的な設定を受け付け、曲にクレジットもかかりません。

オプション 値
bpm 30〜200
timeSignature 2/4、3/4、4/4、6/8
key C major〜B minor（C、C#、D、Eb、E、F、F#、G、Ab、A、Bb、B）
duration 10〜240 秒
negative 避けたいスタイル。最大200文字
thinking 0〜100：ACE-Step が先に曲全体の構成を考える。低いほど自由に、高いほど安定する

3/4 拍子のワルツ、6/8 拍子のジグ、174 bpm のドラムンベースという3つの ACE-Step の曲は、どれも指定どおりの長さで返ってきました（例）。これらのオプションが使えるのは ace-step-1.5-xl の mode generate だけで、それ以外では API が 400 Parameter bpm does not apply to mode generate on acemusic-v1 を返します。スクリプト：ace-step-options/

カバー、リミックス、編集

mode を使うと、手持ちの曲を素材にしたリクエストになります。references にはその曲の songId を渡します。API で作った曲、ライブラリの曲、ご自身でアップロードした曲が使えます。

mode references 実行モデル クレジット 内容
cover 1曲 acemusic-v1.1、または ace-step-1.5-xl の ACE-Step 4 / 0 メロディ、コード、構成を保ったまま、新しい style で曲を作り直す
remix 1曲 ace-step-1.5-xl 0 coverStrength で原曲を残し、remixStrength で原曲から離れる（0〜100）
edit 1曲 ace-step-1.5-xl 0 start 秒から end 秒までを新しい lyrics で作り直し、残りはそのまま
mashup 2曲または3曲 acemusic-v1.1 4 複数の曲から新しい1曲を作る（下記参照）

ACE Music v1.1 は、曲の楽譜から読み取ったメロディに沿って作ります。楽譜がまだない ACE Music v1 の曲で最初にカバーを試したときは ref_no_melody で失敗し、4クレジットは返ってきました。そのため現在の API は、v1.1 のカバーやマッシュアップの前に、ACE Music v1 の曲の楽譜を無料で先に読み取ります。ACE-Step の曲は自動では読み取らないので、400 と ref_no_melody が返ってきたら、まずその曲で GET /music/score を呼び出し（1クレジット）、それからリクエストを送り直してください。スクリプト：covers-remix-edit/

2曲または3曲をマッシュアップする

mode: "mashup" は、同じアカウントにある2曲または3曲から1曲を作ります。lyrics を送らなければ、元の曲の歌詞を組み合わせます。audioInfluence（0〜100、デフォルトは60）で、元の曲にどれだけ忠実に従うかを決めます。マッシュアップは曲を読み取る必要があるため、ACE Music の Web サイトと同じく、v1 を指定しても ACE Music v1.1 Preview で実行されます。私たちの「Harbor Fiesta」は "model": "acemusic-v1" と "modelUsed": "acemusic-v1.1" を返し、クレジットは実際に動いたモデルの分がかかります。v1 で指定した cover、ACE-Step で参照を2つ以上付けたプロンプト、そして参照曲を付けたプロンプトの一部でも同じことが起きます。スクリプト：mashup/

手持ちの音声や画像をもとに曲を作る

POST /files は、ファイルをそのままリクエストの本文として、対応する Content-Type とともに受け取ります。

アップロード 形式 上限 返ってくるもの 使い道
音声 MP3、WAV、FLAC、OGG、M4A、AAC 100 MB、8分 songId：ライブラリの曲になり、歌詞、スタイル、テンポ、メロディが ACE Music によって書き起こされる プロンプトの references（最大3つ）の1つ、またはカバー、リミックス、編集、マッシュアップする曲
画像 JPEG、PNG、WebP 10 MB mediaId プロンプトの images（最大3枚）の1枚：ACE Music がその画像についての曲を書く 
curl -s -X POST "$API/files?title=Harbour%20Jig%20demo" \
  -H "Authorization: Bearer $USEAPI_TOKEN" \
  -H "Content-Type: audio/mpeg" \
  --data-binary @harbour-jig-demo.mp3 | jq '{songId, status, duration, bpm: .upload.bpm}'

アップロードした90秒の「Harbour Jig」は14秒で書き起こされ、ACE Music は 115 bpm と聞き取りました（指定は116でした）。踊るロボットの画像からは、その青緑の毛とオレンジのハイカットスニーカーを歌うドラムンベースの曲ができました。どちらも例に載せています。アップロードはアカウントの上限に数えられ、音声は Free で10分、Creator で30分、Artist で60分までです。スクリプト：upload-reference/

ステム、ダウンロード、楽譜

完成した曲はどれも、ステムに分け、ダウンロードし、楽譜として読み取れます。

リクエスト プラン クレジット 返ってくるもの
ステム、mode: "vocals" Creator、Artist 5 vocal と instrumental の MP3
ステム、mode: "all" Creator、Artist 60 ACE Music が検出したすべてのステムの MP3
ダウンロード mp3（デフォルト） すべてのプラン 0 url（audioUrl と同じ）と playUrl
ダウンロード wav Creator、Artist 0 24時間有効なリンク。ACE-Step の曲には使えない
ダウンロード midi、musicxml Creator、Artist 0 ファイルそのもの
楽譜 すべてのプラン 0、ACE-Step の曲は初回のみ1 ABC 記譜法：ボーカルのメロディ、楽器の旋律、コード、セクション

曲をステムに分ける

「Paper Lanterns」のボーカル分離は約80秒、全パートの分離は2分足らずで終わり、ボーカル、バッキングボーカル、ドラム、ベース、ギター、キーボード、ストリングス、シンセ、FX の9つのステムができました（試聴）。ステムのリンクは24時間有効なので、新しいリンクが必要なら曲を読み直してください。同じモードで同じ曲を再び分離すると、すぐに応答が返り、料金はかかりません。

MP3、WAV、MIDI、MusicXML をダウンロードする

WAV、MIDI、MusicXML は最初のリクエストで ACE Music が作成します。API は最大1分待ってから 202 を返すので、1分後にもう一度呼び出してください。「Paper Lanterns」では3つとも数秒で用意でき、40 MB の WAV、8 KB の MIDI ファイル、107 KB の MusicXML の楽譜になりました。

API 呼び出しを表示 
SONG="user:[email protected]:so_4e7b2c9d0a5f4183b6d8e2c7"

curl -s -G "$API/music/download" --data-urlencode "songId=$SONG" -d format=wav \
  -H "Authorization: Bearer $USEAPI_TOKEN" | jq '{url, expires}'

curl -s -G "$API/music/download" --data-urlencode "songId=$SONG" -d format=midi \
  -H "Authorization: Bearer $USEAPI_TOKEN" -o paper-lanterns.mid

楽譜を読み取る

ABC に対応したツールなら、この楽譜を五線譜にできます。「Paper Lanterns」では 72 bpm と読み取られ、スタイルで指定したテンポと一致しました。ACE Music v1.1 の曲には最初から楽譜が付いていて、v1.1 のカバーやマッシュアップはそれに沿って作られます。カバー、リミックス、編集をご覧ください。

API 呼び出しを表示 
SONG="user:[email protected]:so_4e7b2c9d0a5f4183b6d8e2c7"

curl -s -G "$API/music/score" --data-urlencode "songId=$SONG" \
  -H "Authorization: Bearer $USEAPI_TOKEN" | jq -r .abc | head -14

X:1
T:
M:2/4
L:1/16
Q:1/4=72
V: Vocal clef=treble name="Vocal Melody" snm="Vocal"
V: Ins clef=treble name="Ins Melody" snm="Inst."
K:Ab
% intro
V: Vocal
Z|"Ab"z8|"Ab"z8|"Ab"z8|
V: Ins
Z|Ac2AcBA2|A2EAA2EA|Ac2AcBA2|

スクリプト：stems-and-downloads/。ステム、すべてのダウンロード形式、楽譜を保存します。

ライブラリ

アカウントの曲とアップロードは、ここで作ったものも acemusic.ai で作ったものも、削除するまでライブラリに残ります。

リクエスト 内容
GET /music 曲の一覧を1ページずつ、新しい順に返し、次のページ用に next を付ける。アカウントが2つ以上あるときは email が必要。7日より古いジョブの曲もここにある
GET /music/songId 新しいリンク付きの1曲。分離済みならステムも含む
DELETE /music/songId 204：曲は acemusic.ai のアカウントのゴミ箱に移り、以後 API はその曲に 404 を返す
API 呼び出しを表示 
SONG="user:[email protected]:so_4e7b2c9d0a5f4183b6d8e2c7"

curl -s -G "$API/music" --data-urlencode "[email protected]" -d limit=20 \
  -H "Authorization: Bearer $USEAPI_TOKEN" | jq '{next, songs: [.songs[] | {title, model, kind, songId}]}'

curl -s "$API/music/$(jq -rn --arg v "$SONG" '$v|@uri')" \
  -H "Authorization: Bearer $USEAPI_TOKEN" | jq '{title, score, audioUrl, playUrl, stems: (.stems // {} | keys)}'

curl -s -o /dev/null -w "%{http_code}\n" -X DELETE "$API/music/$(jq -rn --arg v "$SONG" '$v|@uri')" \
  -H "Authorization: Bearer $USEAPI_TOKEN"

スクリプト：library/

複数の ACE Music アカウント

useapi.net のサブスクリプション1つにつき ACE Music のアカウントを3つ接続でき、合計で最大100アカウントまで使えます。email を指定しないリクエストは、空きのある正常なアカウントに送られ、曲、アップロード、画像を指定したリクエストは、それがあるアカウントで実行されます。各アカウントは同時に最大 maxJobs 件のリクエストを実行でき、デフォルトは ACE Music 自体の上限と同じ4件です。すべてのアカウントが埋まっていると API は Retry-After 付きで 429 を返し、ACE Music にパスワードを拒否されたアカウントは、追加し直すまで 596 を返します。

GET /accounts/email はプラン、クレジット、クレジットの単価をその場で読み取ります。POST /accounts に email と maxJobs だけを送ると、maxJobs だけが変わります。スクリプト：accounts/

API 呼び出しを表示 
curl -s "$API/accounts/$(jq -rn --arg v "[email protected]" '$v|@uri')" \
  -H "Authorization: Bearer $USEAPI_TOKEN" | jq '{plan_name, credits, maxJobs, costs}'

curl -s -X POST "$API/accounts" \
  -H "Authorization: Bearer $USEAPI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "email": "[email protected]", "maxJobs": 2 }'

Claude、ChatGPT、Cursor から使う（MCP）

同じ機能が、15のツールを備えたホスト型の MCP サーバーとしても使えます。曲、カバー、マッシュアップから、ステム、楽譜、アップロードまで対応しています。ACE Music 自体は公開の MCP 連携を提供していません（2026年11月時点）。Claude Code ならコマンド1つで追加できます。

claude mcp add --transport http useapi-acemusic https://api.useapi.net/v1/acemusic/mcp --header "Authorization: Bearer YOUR_API_TOKEN"

Cursor、VS Code、Windsurf では同じ URL とヘッダーを使い、Claude アプリと ChatGPT は OAuth でサインインします。Claude アプリや ChatGPT で使うをご覧ください。あとは普通の言葉で頼むだけです。たとえば「雨の日が大好きな猫の歌詞を書いて、ACE Music v1 でアコースティックなインディーフォークとして歌わせて」のように頼めます。

スクリプトで一括生成する

acemusic-api GitHub リポジトリには機能ごとに1つずつ例があり、上の各セクションからリンクしています。どれも Node.js のスクリプトとそれに対応する Python 版があり、インストールは不要です。それぞれ、編集した prompts.json からリクエストを読み込み、同時に最大4件実行し、ジョブをポーリングして、2曲、そのカバーアート、ジョブの記録、使ったクレジットの ledger.jsonl を output/ フォルダーに保存します。

Node.js 21 以降、または Python 3.8 以降が必要です。--only 3 は下の3番目のプロンプトを実行します。クレジット不要の ACE-Step の曲なので、Free アカウントでも動きます。

git clone https://github.com/useapi/acemusic-api.git && cd acemusic-api
export USEAPI_TOKEN="user:12345-..."
node songs-from-prompt/songs-from-prompt.mjs --only 3

保存されたジョブの記録には各曲の songId が入っていて、--from <job>.json --pick 1 を付けると1曲目を次のスクリプトに渡し、カバー、マッシュアップ、ステム分離ができます。

songs-from-prompt/prompts.json を表示 
[
    {
        "_about": "ACE Music v1 (the default model, 4 credits for two songs): ACE Music writes the style, lyrics and title from your idea",
        "prompt": "A late-night neo-soul slow jam about two strangers sharing an umbrella at a bus stop in the rain and missing the last bus on purpose. Warm Rhodes piano, brushed drums, round upright bass, a smoky female lead with close three-part harmonies on the chorus.",
        "model": "acemusic-v1"
    },
    {
        "_about": "ACE Music v1.1 Preview (4 credits): writes a score first, then the audio",
        "prompt": "An anthemic Celtic folk-rock singalong about a fishing crew racing a storm back to the harbor. Fiddle and tin whistle hooks, stomping kick drum, bodhran, a gravelly male lead and the whole crew shouting the chorus.",
        "model": "acemusic-v1.1"
    },
    {
        "_about": "ACE-Step v1.5 XL (no credits on any ACE Music plan, the Free plan included)",
        "prompt": "A breezy bossa nova for a lazy Sunday afternoon in Lisbon: nylon-string guitar, soft brushed snare, upright bass, a gentle flute line and a warm male and female duet sung in Portuguese.",
        "model": "ace-step-1.5-xl"
    }
]

例

以下の曲はすべて、2026年11月14日（PST）にリポジトリのスクリプトで ACE Music の Artist アカウントを使って作ったもので、各リクエストの2曲のうち1曲目です。タイトルは、こちらで指定したもの以外は ACE Music が付けました。時間はリクエストから2曲とも完成するまでのもので、呼び出し例の ID は架空のものです。

画像から作った曲

画像1枚とスタイルの1文を送ると、完成した2曲が返ってきます。踊るロボットのマスコットの画像をアップロードし、ドラムンベースを頼んだところ、ACE Music は画像から読み取った内容で歌詞を書きました。「Teal fur shaking on the concrete floor, orange high-tops squeaking by the studio door」

箱型の頭、アンテナ、光る目を持つふわふわの青緑のロボットのマスコットが、オレンジのハイカットスニーカーで踊っている

Bouncy, playful drum and bass for a dancing robot mascot: rolling breakbeats at
174 bpm, a wobbly reese bass, bleepy robot synth hooks, vocoder chops, cheeky and
upbeat.

ACE Music v1 —「Bleep Boop Bounce」· 2:47 · 生成 72秒

API 呼び出しを表示 
curl -X POST 'https://api.useapi.net/v1/acemusic/files' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: image/png' \
  --data-binary @robot-mascot.png

curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "Bouncy, playful drum and bass for a dancing robot mascot: rolling breakbeats at 174 bpm, a wobbly reese bass, bleepy robot synth hooks, vocoder chops, cheeky and upbeat.",
    "model": "acemusic-v1",
    "images": ["user:[email protected]:cx_3b9e1d7a5c2f48e0a6d4b8c1"],
    "async": true
  }'

プロンプトから作った曲

プロンプトから作った ACE Music v1 の曲「Let the 44 Roll By」は、手順の説明に載せています。ここでは、ほかの2つのモデルでもう2つのプロンプトを試しました。

An anthemic Celtic folk-rock singalong about a fishing crew racing a storm back
to the harbor. Fiddle and tin whistle hooks, stomping kick drum, bodhran, a
gravelly male lead and the whole crew shouting the chorus.

ACE Music v1.1 Preview —「Haul for the Harbor Light」· 2:51 · 生成 43秒

API 呼び出しを表示 
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "An anthemic Celtic folk-rock singalong about a fishing crew racing a storm back to the harbor. Fiddle and tin whistle hooks, stomping kick drum, bodhran, a gravelly male lead and the whole crew shouting the chorus.",
    "model": "acemusic-v1.1",
    "async": true
  }'

A breezy bossa nova for a lazy Sunday afternoon in Lisbon: nylon-string guitar,
soft brushed snare, upright bass, a gentle flute line and a warm male and female
duet sung in Portuguese.

ACE-Step v1.5 XL、クレジット不要 —「Domingo em Alfama」· 3:28

API 呼び出しを表示 
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "A breezy bossa nova for a lazy Sunday afternoon in Lisbon: nylon-string guitar, soft brushed snare, upright bass, a gentle flute line and a warm male and female duet sung in Portuguese.",
    "model": "ace-step-1.5-xl",
    "async": true
  }'

自作の歌詞で作った曲

自分たちで書いた2つのヴァース、プリコーラス、ブリッジ、アウトロで、長さは210秒を指定しました。

Style:  cinematic indie pop ballad, felt piano, swelling strings, deep heartbeat
        kick, intimate female vocal that opens up into a soaring chorus, 72 bpm
Lyrics: [Verse 1] We wrote our names on paper lanterns / Down by the river in July …
        [Chorus] Light it up and let it go / Every word I never said out loud …

ACE Music v1 —「Paper Lanterns」· 3:29 · 生成 61秒

API 呼び出しを表示 
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Paper Lanterns",
    "style": "cinematic indie pop ballad, felt piano, swelling strings, deep heartbeat kick, intimate female vocal that opens up into a soaring chorus, 72 bpm",
    "lyrics": "[Verse 1]\nWe wrote our names on paper lanterns\nDown by the river in July\nYou said the wind would know the answer\nIf we just let the fire fly\nYour hand was shaking, mine was steady\nAt least that'\''s how I tell it now\nWe watched them climb until the city\nWas just a glow beneath the clouds\n\n[Pre-Chorus]\nSo every summer I come back here\nStrike a match and hold it near\n\n[Chorus]\nLight it up and let it go\nEvery word I never said out loud\nLight it up and let it go\nHigher than the both of us somehow\nAnd if it finds you anyhow\nTell me you can see it from the clouds\n\n[Verse 2]\nThey tore the old pier down last winter\nPut up a fence and painted lines\nBut I still know the way by heartbeat\nI find the water every time\nI keep a lighter in my pocket\nI keep your laugh inside my head\nI fold the paper like you showed me\nAnd write the things I should have said\n\n[Pre-Chorus]\nSo every summer I come back here\nStrike a match and hold it near\n\n[Chorus]\nLight it up and let it go\nEvery word I never said out loud\nLight it up and let it go\nHigher than the both of us somehow\nAnd if it finds you anyhow\nTell me you can see it from the clouds\n\n[Bridge]\nPaper and fire, paper and fire\nNothing this light should rise so high\nPaper and fire, paper and fire\nMaybe that'\''s how we say goodbye\n\n[Final Chorus]\nLight it up and let it go\nEvery word I never said out loud\nLight it up and let it go\nHigher than the both of us somehow\n\n[Outro]\nDown by the river in July",
    "model": "acemusic-v1",
    "duration": 210,
    "async": true
  }'

インストです。instrumental: true、150秒で、ボーカル、合唱、アコースティックギターを除外しました。

Style:  cinematic synthwave instrumental for a night drive: pulsing analog bass
        arpeggio, gated reverb drums, lush pads, a soaring lead synth melody,
        builds to a big final section, 108 bpm

ACE Music v1 —「Neon Overpass」· 2:29 · 生成 46秒

API 呼び出しを表示 
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Neon Overpass",
    "style": "cinematic synthwave instrumental for a night drive: pulsing analog bass arpeggio, gated reverb drums, lush pads, a soaring lead synth melody, builds to a big final section, 108 bpm",
    "instrumental": true,
    "model": "acemusic-v1",
    "duration": 150,
    "negative": "vocals, choir, acoustic guitar",
    "async": true
  }'

停電の夜の屋上パーティーを歌った、スペイン語の歌詞です。

Style:  modern cumbia pop, bright accordion hooks, güira and congas, warm bass,
        a festive male lead with a crowd shouting the chorus, 98 bpm
Lyrics: [Chorus] Bailando en la azotea / Con las estrellas de farol …

ACE Music v1 —「Bailando en la Azotea」· 2:32 · 生成 46秒

API 呼び出しを表示 
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Bailando en la Azotea",
    "style": "modern cumbia pop, bright accordion hooks, güira and congas, warm bass, a festive male lead with a crowd shouting the chorus, 98 bpm",
    "lyrics": "[Verse 1]\nSe fue la luz en todo el barrio\nY nadie quiere irse a dormir\nDoña Rosa saca el radio viejo\nY la noche empieza a sonreír\nLos vecinos suben con sus sillas\nAlguien trae limones y café\nY la ciudad allá abajo, oscura\nNos mira bailar sin saber por qué\n\n[Pre-Chorus]\nSube, sube, que la luna está invitando\nSube, sube, que la calle está cantando\n\n[Chorus]\nBailando en la azotea\nCon las estrellas de farol\nQue se entere todo el mundo\nQue esta noche no hay apagón\nBailando en la azotea\nCon el corazón de tambor\nSi se apaga la ciudad entera\nAquí arriba sobra amor\n\n[Verse 2]\nEl abuelo saca la guitarra\nLa vecina de enfrente se animó\nLos niños corren entre las sábanas\nQue el viento de la tarde colgó\nNadie sabe cuándo vuelve la corriente\nY la verdad, a nadie le importó\nEsta fiesta no la paga nadie\nEsta fiesta la invitó el apagón\n\n[Chorus]\nBailando en la azotea\nCon las estrellas de farol\nQue se entere todo el mundo\nQue esta noche no hay apagón\nBailando en la azotea\nCon el corazón de tambor\nSi se apaga la ciudad entera\nAquí arriba sobra amor\n\n[Outro]\nQue esta noche no hay apagón",
    "model": "acemusic-v1",
    "async": true
  }'

歌詞は歌詞の作成ツール、スタイルはスタイルの作成ツールが書き、ACE-Step が歌いました。

Lyrics writer: A wistful country song about an old pickup truck that still has
               her mixtape stuck in the tape deck
Style writer:  classic country ballad, pedal steel, warm baritone

ACE-Step v1.5 XL、クレジット不要 —「Side B Forever」· 3:35 · 生成 40秒（その前に歌詞 6秒、スタイル 4秒）

API 呼び出しを表示 
curl -X POST 'https://api.useapi.net/v1/acemusic/music/lyrics' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "A wistful country song about an old pickup truck that still has her mixtape stuck in the tape deck",
    "style": "classic country ballad, pedal steel, warm baritone",
    "model": "ace-step-1.5-xl"
  }' > lyrics.json

curl -X POST 'https://api.useapi.net/v1/acemusic/music/style' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "style": "classic country ballad, pedal steel, warm baritone",
    "model": "ace-step-1.5-xl"
  }' > style.json

# sing what the writers returned
jq -n --slurpfile l lyrics.json --slurpfile s style.json \
  '{title: $l[0].title, lyrics: $l[0].lyrics, style: $s[0].style, model: "ace-step-1.5-xl", async: true}' |
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d @-

テンポ、キー、拍子を指定した ACE-Step

どれも指定どおりの長さで返ってきました。

3/4 · 84 bpm · D minor · 120 s · thinking 60 · avoid: trap drums, EDM, autotune
Style: dark cabaret waltz, accordion, pizzicato strings, upright bass, brushed
       snare, theatrical female vocal

ACE-Step v1.5 XL、クレジット不要 —「Midnight Waltz」· 2:00 · 生成 31秒

API 呼び出しを表示 
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "ace-step-1.5-xl",
    "title": "Midnight Waltz",
    "style": "dark cabaret waltz, accordion, pizzicato strings, upright bass, brushed snare, theatrical female vocal",
    "lyrics": "[Verse 1]\nThe band plays slow when the lights go low\nAnd the chandeliers begin to sway\nTake my hand, we will dance till the candles stand\nIn puddles of yesterday\n\n[Chorus]\nOne, two, three, turn around with me\nRound and round till the morning comes\nOne, two, three, oh don'\''t let me be\nThe last one dancing when the music'\''s done\n\n[Verse 2]\nThe clock strikes twelve and it laughs at itself\nEvery mirror wears a stranger'\''s face\nHold me close, we are only ghosts\nWho forgot to leave this place\n\n[Chorus]\nOne, two, three, turn around with me\nRound and round till the morning comes\nOne, two, three, oh don'\''t let me be\nThe last one dancing when the music'\''s done",
    "bpm": 84,
    "timeSignature": "3/4",
    "key": "D minor",
    "duration": 120,
    "negative": "trap drums, EDM, autotune",
    "thinking": 60,
    "async": true
  }'

6/8 · 116 bpm · G major · 90 s · instrumental
Style: lively celtic instrumental jig, fiddle and tin whistle trading the melody,
       bodhran, strummed bouzouki, foot stomps

ACE-Step v1.5 XL、クレジット不要 —「Harbour Jig」· 1:30 · 生成 20秒

API 呼び出しを表示 
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "ace-step-1.5-xl",
    "title": "Harbour Jig",
    "style": "lively celtic instrumental jig, fiddle and tin whistle trading the melody, bodhran, strummed bouzouki, foot stomps",
    "instrumental": true,
    "bpm": 116,
    "timeSignature": "6/8",
    "key": "G major",
    "duration": 90,
    "async": true
  }'

4/4 · 174 bpm · F minor · 150 s · thinking 80
Style: liquid drum and bass, rolling breakbeats, deep warm sub bass, airy pads,
       soulful female vocal

ACE-Step v1.5 XL、クレジット不要 —「Almost Home」· 2:30 · 生成 41秒

API 呼び出しを表示 
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "ace-step-1.5-xl",
    "title": "Almost Home",
    "style": "liquid drum and bass, rolling breakbeats, deep warm sub bass, airy pads, soulful female vocal",
    "lyrics": "[Verse]\nCity lights in the rear view mirror\nRunning on a borrowed night\nEvery bridge is a little bit nearer\nEvery tunnel full of light\n\n[Chorus]\nHold on, we'\''re almost home\nEvery signal turning green\nHold on, you'\''re not alone\nFaster than the in-between\n\n[Verse]\nRadio low and the windows open\nBreathing in the summer rain\nEvery promise we left unspoken\nRushing back to us again\n\n[Chorus]\nHold on, we'\''re almost home\nEvery signal turning green\nHold on, you'\''re not alone\nFaster than the in-between",
    "bpm": 174,
    "timeSignature": "4/4",
    "key": "F minor",
    "duration": 150,
    "thinking": 80,
    "async": true
  }'

カバー、リミックス、編集の例

「Paper Lanterns」のカバーです。メロディはそのままに、新しいスタイルにしました。

mode: cover · stripped-back acoustic folk cover, fingerpicked steel-string guitar,
warm cello, soft close-mic'd male vocal

ACE Music v1.1 Preview —「Paper Lanterns (Acoustic Folk Cover)」· 3:34 · 生成 72秒

API 呼び出しを表示 
# our script read the score first (free for an ACE Music v1 song; the API now does this by itself)
curl 'https://api.useapi.net/v1/acemusic/music/score?songId=user%3A12345-example%40example.com-song%3Aso_4e7b2c9d0a5f4183b6d8e2c7' \
  -H 'Authorization: Bearer user:12345-…' > /dev/null

curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "mode": "cover",
    "model": "acemusic-v1.1",
    "references": ["user:[email protected]:so_4e7b2c9d0a5f4183b6d8e2c7"],
    "style": "stripped-back acoustic folk cover, fingerpicked steel-string guitar, warm cello, soft close-mic'\''d male vocal",
    "async": true
  }'

「Bailando en la Azotea」をディープハウスにしました。タイトルを送らなかったので、ACE Music は「Reference 1」と名付けました。

mode: remix · coverStrength 40 · remixStrength 50 · deep house remix,
four-on-the-floor kick, plucky chords, rolling bassline, filtered vocal chops

ACE-Step v1.5 XL、クレジット不要 —「Reference 1」· 2:32 · 生成 31秒

API 呼び出しを表示 
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "mode": "remix",
    "model": "ace-step-1.5-xl",
    "references": ["user:[email protected]:so_9d3b7e2c1a6f4085b8e4d1c6"],
    "style": "deep house remix, four-on-the-floor kick, plucky chords, rolling bassline, filtered vocal chops",
    "coverStrength": 40,
    "remixStrength": 50,
    "async": true
  }'

「Paper Lanterns」の30秒から50秒までを新しい歌詞にし、残りはそのままにしました。

mode: edit · start 30 · end 50
Lyrics: We wrote our names on paper lanterns / Down by the harbor in the snow /
        You said the stars would keep the answer / If we were brave enough to go

ACE-Step v1.5 XL、クレジット不要 —「Reference 1」· 3:29 · 生成 41秒

API 呼び出しを表示 
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "mode": "edit",
    "model": "ace-step-1.5-xl",
    "references": ["user:[email protected]:so_4e7b2c9d0a5f4183b6d8e2c7"],
    "start": 30,
    "end": 50,
    "style": "cinematic indie pop ballad, felt piano, swelling strings, intimate female vocal",
    "lyrics": "We wrote our names on paper lanterns\nDown by the harbor in the snow\nYou said the stars would keep the answer\nIf we were brave enough to go",
    "async": true
  }'

マッシュアップ

「Paper Lanterns」と「Let the 44 Roll By」：

upbeat neo-soul pop mashup, punchy live drums, warm Rhodes and strings, female
lead with a gospel-tinged choir on the chorus · audioInfluence 60

ACE Music v1.1 Preview —「Lanterns at the Bus Stop」· 3:58 · 生成 83秒

API 呼び出しを表示 
# our script read each song's score first (the API now does this by itself for ACE Music v1 songs)
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "mode": "mashup",
    "model": "acemusic-v1.1",
    "references": ["user:[email protected]:so_4e7b2c9d0a5f4183b6d8e2c7", "user:[email protected]:so_7c1d9e3a5b2f4806a4e1c9d3"],
    "title": "Lanterns at the Bus Stop",
    "style": "upbeat neo-soul pop mashup, punchy live drums, warm Rhodes and strings, female lead with a gospel-tinged choir on the chorus",
    "audioInfluence": 60,
    "async": true
  }'

「Haul for the Harbor Light」と「Bailando en la Azotea」を、ACE Music v1 を指定してマッシュアップしました。

festive celtic cumbia mashup, fiddle and accordion trading hooks, congas and
bodhran, stomping kick, male lead with a big crowd chorus

ACE Music v1.1 Preview（指定は v1）—「Harbor Fiesta」· 2:38 · 生成 74秒

API 呼び出しを表示 
# our script read each song's score first (the API now does this by itself for ACE Music v1 songs)
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "mode": "mashup",
    "model": "acemusic-v1",
    "references": ["user:[email protected]:so_2a8f6c1e9d4b47f3b0c5e8a2", "user:[email protected]:so_9d3b7e2c1a6f4085b8e4d1c6"],
    "title": "Harbor Fiesta",
    "style": "festive celtic cumbia mashup, fiddle and accordion trading hooks, congas and bodhran, stomping kick, male lead with a big crowd chorus",
    "async": true
  }'

3曲を一度に：「Paper Lanterns」、「Bailando en la Azotea」、「Let the 44 Roll By」

warm late-night soul-pop medley, Rhodes and strings, light latin percussion,
female lead with a male answer on the last chorus

ACE Music v1.1 Preview —「Three Songs, One Night」· 3:32 · 生成 43秒

API 呼び出しを表示 
# our script read each song's score first (the API now does this by itself for ACE Music v1 songs)
curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "mode": "mashup",
    "model": "acemusic-v1.1",
    "references": ["user:[email protected]:so_4e7b2c9d0a5f4183b6d8e2c7", "user:[email protected]:so_9d3b7e2c1a6f4085b8e4d1c6", "user:[email protected]:so_7c1d9e3a5b2f4806a4e1c9d3"],
    "title": "Three Songs, One Night",
    "style": "warm late-night soul-pop medley, Rhodes and strings, light latin percussion, female lead with a male answer on the last chorus",
    "async": true
  }'

手持ちの音声と画像

上の「Harbour Jig」を MP3 としてアップロードし、プロンプトの参照にしました。ACE Music は曲調を保つため v1.1 で実行しました。

A rowdy pub singalong with a big shouted chorus about the last ferry home, built
on the tune of this recording

ACE Music v1.1 Preview（指定は v1）—「Last Ferry Home」· 1:36 · 生成 52秒

API 呼び出しを表示 
curl -X POST 'https://api.useapi.net/v1/acemusic/files?title=Harbour%20Jig%20demo' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: audio/mpeg' \
  --data-binary @harbour-jig-demo.mp3

curl -X POST 'https://api.useapi.net/v1/acemusic/music' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "A rowdy pub singalong with a big shouted chorus about the last ferry home, built on the tune of this recording",
    "model": "acemusic-v1",
    "references": ["user:[email protected]:so_5f1a3c8e7b2d49a6c3e0f7b9"],
    "async": true
  }'

「Paper Lanterns」のステム

mode: "vocals"（5クレジット）で得たボーカルとインスト、続いて mode: "all"（60クレジット）で得た9つのステムのうちドラムとストリングスです。

API 呼び出しを表示 
curl -X POST 'https://api.useapi.net/v1/acemusic/music/stems' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "songId": "user:[email protected]:so_4e7b2c9d0a5f4183b6d8e2c7",
    "mode": "vocals",
    "async": true
  }'

curl -X POST 'https://api.useapi.net/v1/acemusic/music/stems' \
  -H 'Authorization: Bearer user:12345-…' \
  -H 'Content-Type: application/json' \
  -d '{
    "songId": "user:[email protected]:so_4e7b2c9d0a5f4183b6d8e2c7",
    "mode": "all",
    "async": true
  }'

よくある質問

ACE Music の API はありますか？
useapi.net を使えば、あります。ACE Music API は、ACE Music v1、ACE Music v1.1 Preview、ACE-Step v1.5 XL を、お使いの ACE Music アカウントで REST から実行し、カバー、マッシュアップ、ステム、MIDI にも対応します。ACE Music v1 と v1.1 には独自の公開 API がない（2026年11月時点）ため、コードから呼び出す方法は useapi.net だけです。ACE Music 自体の API は旧版の ACE-Step v1.5 を動かすもので、新しい API キーの受付を停止しています。

無料の ACE-Step API はありますか？
useapi.net を使えば、あります。ACE-Step v1.5 XL の曲は、Free プランを含むどの ACE Music のプランでもクレジットを消費せず、テンポ、キー、拍子、長さの設定、リミックス、編集にも対応します。サードパーティの acestep.io は、ACE-Step API を月額 $49 の Studio プランでしか提供しておらず、1曲あたり約 $0.14 です（2026年11月時点）。

API で ACE Music v1 の曲を作るといくらかかりますか？
useapi.net なら、ACE Music v1 の曲は1曲につきお使いの ACE Music のプランの2クレジットで、Artist の年払いなら $0.013、Artist の月払いなら $0.023 です。曲ごとの上乗せはありません。ACE Music v1 はどの公開 API でも提供されていない（2026年11月時点）ため、コードから1曲ずつ支払う方法は、プランのクレジットを使うことだけです。料金をご覧ください。

ACE Music の MCP サーバーはありますか？
useapi.net を使えば、あります。15のツールを備えたホスト型の ACE Music MCP サーバーで、Claude アプリ、ChatGPT、Claude Code、Cursor から、お使いの ACE Music アカウントで曲、カバー、マッシュアップ、ステムを作れます。インストールは不要です。ACE Music 自体は公開の MCP 連携を提供していません（2026年11月時点）。

おわりに

POST を1回送るだけで、ボーカルのリーダーボードで首位のモデルが2曲を作ります。ACE-Step の曲は無料で、どの曲も次の呼び出しでカバー、マッシュアップ、ステム、MIDI ファイルにできます。acemusic-api リポジトリをクローンし、Free アカウントで songs-from-prompt/ を --only 3 付きで実行してみてください。すべてのオプションは POST /music にあります。

ご質問は Discord サーバー または Telegram チャンネルへどうぞ。