音声
ACE-Step 音楽ジェネレーター
スタイルを入力し、歌詞を加えて、ボーカル入りの楽曲をダウンロード。接続したデバイスで無料のテキストから音楽生成。
ACE-Step by ACE Studio and StepFun; Qwen3 Embedding by Alibaba Cloud
モデルのライセンス
ACE-Step v1.5 turbo DiT, lyric encoder and derived conditioning · MIT AND Apache-2.0
Retain MIT copyright/permission/disclaimer and applicable full Apache-2.0 terms, preserve upstream notices and identify modifications. Apache patent termination and trademark limitations apply.
ACE-Step v1.5 audio VAE decoder · MIT
Retain MIT copyright/permission/disclaimer, preserve upstream notices and identify modifications.
Qwen3 Embedding 0.6B text encoder and tokenizer · Apache-2.0
Retain full Apache-2.0 terms, preserve upstream notices and identify modifications. Apache patent termination and trademark limitations apply.
API リファレンス
REST で送信
個人用 API キー(msk_…)を使うと、ご自身のツールからこのワークロードのジョブを作成できます。この方法で開始したジョブは、あなたのデバイス で接続したのと同じデバイスで実行されます。少なくとも 1 台がオンラインである必要があります。
https://cp.meshlabs.cloud/v1/organizations/jobsX-Organization-Api-Key: msk_your_personal_api_key で認証します。ヘッダー名は組織キーと同じで、個人キーも同じエンドポイントを使用します。
リクエストボディ
{
"workload_type": "ace-step-15-turbo-music",
"job_spec": {
"prompt": "A photorealistic lighthouse at dusk",
"vocalLanguage": "en",
"durationSec": 60,
"shift": 3
}
}job_spec のフィールド
| フィールド | 必須 | デフォルト | 説明 |
|---|---|---|---|
prompt | はい | — | ジャンル、楽器編成、雰囲気、ボーカルの特徴。 |
lyrics | いいえ | — | 任意。[verse] / [chorus] / [bridge] などの構成タグに対応しています。インストにする場合は空欄のままにしてください。 |
vocalLanguage | いいえ | en | 歌詞の言語コード(例: en、zh、ja、es)。インストの場合は無視されます。 |
durationSec | いいえ | 60 | 曲の長さ。ジョブでこの項目を省略した場合は 60 秒で実行されます。 |
shift | いいえ | 3 | タイムステップのスケジュール。3 は忠実度を、1 はプロンプトへの忠実さを重視します。 |
seed | いいえ | — | 省略するとランダムな曲になります。同じ曲を再現したい場合に指定します。 |
bpm | いいえ | — | 省略するとモデルが選びます。 |
keyScale | いいえ | — | 例: C メジャー、A マイナー。省略するとモデルが選びます。 |
timeSignature | いいえ | — | 1小節あたりの拍数。例: 4 なら 4/4、3 なら 3/4。 |
cURL
curl -X POST https://cp.meshlabs.cloud/v1/organizations/jobs \
-H "X-Organization-Api-Key: msk_your_personal_api_key" \
-H "Content-Type: application/json" \
-d '{
"workload_type": "ace-step-15-turbo-music",
"job_spec": {
"prompt": "A photorealistic lighthouse at dusk",
"vocalLanguage": "en",
"durationSec": 60,
"shift": 3
}
}'https://cp.meshlabs.cloud/v1/organizations/jobs/{job_id}status が終了状態(COMPLETED、FAILED、CANCELED、MODERATION_BLOCKED)になるまで、同じ API キーでポーリングします。コンテンツモデレーションが有効な場合、ジョブはコンピュートキューに入る前に MODERATION_PENDING から始まることがあります。完了したジョブには、各出力に署名済みの download_url の値が含まれます。
作成時のレスポンス
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"workload_type": "ace-step-15-turbo-music",
"status": "PENDING",
"job_spec_json": {
"prompt": "A photorealistic lighthouse at dusk",
"vocalLanguage": "en",
"durationSec": 60,
"shift": 3
},
"work_units": [],
"outputs": [],
"created_at": "2026-06-08T12:00:00Z",
"updated_at": "2026-06-08T12:00:00Z"
}完了時のレスポンス
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"workload_type": "ace-step-15-turbo-music",
"status": "COMPLETED",
"job_spec_json": {
"prompt": "A photorealistic lighthouse at dusk",
"vocalLanguage": "en",
"durationSec": 60,
"shift": 3
},
"work_units": [
{
"id": "…",
"index": 0,
"status": "COMPLETED"
}
],
"outputs": [
{
"id": "…",
"output_type": "<output type>",
"filename": "<output filename>",
"size_bytes": 524288,
"download_url": "<presigned output download URL>"
}
],
"created_at": "2026-06-08T12:00:00Z",
"updated_at": "<completion timestamp>"
}スタイルと任意の歌詞を入力すると、歌声入りの楽曲(最長約4分のステレオ音声)をダウンロードできます。接続したデバイスで無料のテキストから音楽生成。初回はモデルをダウンロードしますが、2曲目以降はより速く始まります。