ComfyUIのAPIでACE-Step音楽生成をPythonから実行する

管理者

編集者

◉ 2025.12.14 · 7min

前回はComfyUI上でACE-Stepを動かして音楽を作りました。

パレイド

簡単にローカルで試せる音楽生成AI: ComfyUIでACE-Stepを使う

ComfyUIのテンプレートを使い、ACE-Stepでインストゥルメンタル／歌入り音楽を生成して保存するまでを、迷わずできる形でまとめます。

同じワークフローをそのまま「APIで叩ける形」にして、Pythonから実行できる状態にします。

API用JSONの書き出しから実行、完了確認、出力ファイルの取得までを試してみましょう。

ComfyUIのAPIでできること

ComfyUIは、画面からのノード操作に加えて、HTTP APIとWebSocketを提供します。

ワークフロー実行は基本的に POST /prompt でキューに投入し、進捗は /ws で受け取り、結果は /history/{prompt_id} で確認する流れです。

これらの主要ルートは公式ドキュメントにまとまっています。
Routes – ComfyUI

API用のJSONをエクスポートする

ComfyUIには、通常のワークフローJSONエクスポートとは別に、API実行向けに最適化されたJSON形式があります。

利用したいワークフローを開いた状態で、UIのアイコンメニューから「ファイル」→「エクスポート (API)」を選択します。

適宜、ファイル名をつけて保存します。

外部からのAPI呼び出しはこのJSONを使うと簡単です。

Pythonで入力パラメータを差し替えてPOSTする

公式ドキュメントでは、/prompt にワークフローをPOSTして実行キューに入れる流れが説明されています。

画像の例が多いのですが、ACE-Stepの場合は、曲調タグや歌詞を入力するノードのinputsを差し替えます。

保存したAPI用JSONを開き、画面上のノードのタイトル”TextEncodeAceStepAudio“で検索すると、入力内容が入ったノードが見つかります。

  ...
  "74:14": {
    "inputs": {
      "tags": "medieval fantasy, night, campfire, calm, healing,\nbackground music, ambient, lute, flute, soft strings, pad, bell\n",
      "lyrics": "[instrumental]",
      "lyrics_strength": 0.9900000000000002,
      "clip": [
        "74:40",
        1
      ]
    },
    "class_type": "TextEncodeAceStepAudio",
    "_meta": {
      "title": "TextEncodeAceStepAudio"
    }
  }
  ...

利用環境や入力した内容によって、タグは変わる可能性があります。

ChatGPTなど生成AIにJSONを見せてコードを書いて貰う方法も有効ですが、AIはよくタグ指定を間違うので目視して確かめることをお勧めします。

実行は、ComfyUIが起動した状態で POST /prompt を呼び出し、成功時はレスポンスとしてprompt_idが返ります。

import json
import uuid
import requests

server = "http://127.0.0.1:8188"
client_id = str(uuid.uuid4())

with open("workflow_api.json", "r", encoding="utf-8") as f:
    prompt = json.load(f)

# 例：ノードID 74:14内の曲調タグ"tags"、歌詞"lyrics"を指定。JSONに合わせて差し替える
prompt["74:14"]["inputs"]["tags"] = "lofi, warm, mellow, jazz"
prompt["74:14"]["inputs"]["lyrics"] = "[instrumental]"

payload = {"prompt": prompt, "client_id": client_id}
r = requests.post(f"{server}/prompt", json=payload, timeout=60)
r.raise_for_status()
prompt_id = r.json()["prompt_id"]

これで画面上のUIにプロンプトを入力し、実行ボタンを押したと同じ処理となり、ComfyUIサーバ側でワークフローが実行されます。

環境によりますが生成には数分程度かかるため、生成が終わったタイミングでダウンロードを行う必要があります。

今回のようにローカルでのComfyUI実行であれば、終わった頃にComfyUIの出力フォルダを直接覗く方法もシンプルです。