音频

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.

免费在线无限ACE-Step by ACE Studio and StepFun; Qwen3 Embedding by Alibaba Cloud API 访问

API 参考

通过 REST 提交

使用您的个人 API 密钥(msk_…),从您自己的工具为此工作负载创建任务。以这种方式启动的任务会在您于您的设备中连接的同一批设备上运行——至少需要有一台在线。

隐藏 API 详情
POSThttps://cp.meshlabs.cloud/v1/organizations/jobs

使用 X-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否—每小节的拍数,例如 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
  }
}'
GEThttps://cp.meshlabs.cloud/v1/organizations/jobs/{job_id}

使用同一 API 密钥轮询,直到 status 进入终态(COMPLETED、FAILED、CANCELED 或 MODERATION_BLOCKED)。启用内容审核时,任务可能会先处于 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>"
}

描述曲风,可选添加歌词,即可下载带人声演唱的歌曲,立体声音频最长约四分钟。在您连接的设备上免费文字生成音乐。首次运行会下载模型,之后的歌曲启动更快。