音频
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_…),从您自己的工具为此工作负载创建任务。以这种方式启动的任务会在您于您的设备中连接的同一批设备上运行——至少需要有一台在线。
https://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
}
}'https://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>"
}描述曲风,可选添加歌词,即可下载带人声演唱的歌曲,立体声音频最长约四分钟。在您连接的设备上免费文字生成音乐。首次运行会下载模型,之后的歌曲启动更快。