如何用 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. 混搭两首或三首歌
  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 调用，就能用你已有的 ACE Music 订阅，从 ACE Music 拿到两首完整的歌曲，带人声、歌词、标题和封面。ACE Music v1 在 Artificial Analysis 人声音乐排行榜上排名第一，领先 Suno v6；而 ACE Music v1 和 v1.1 没有自己的公开 API（截至 2026 年 11 月），所以 useapi.net 是用代码调用它们的唯一途径。开源的 ACE-Step v1.5 XL 也通过同一个 API 运行，在任何 ACE Music 套餐上都不消耗积分，免费套餐也一样。

本指南先介绍三个模型和每首歌的费用，再用 curl 从头到尾生成一首歌，然后用一张简短的表格介绍其他所有功能。文末的示例是我们为本页制作的 18 首歌，每首都附有生成它的请求，全部由 acemusic-api GitHub 仓库中的脚本（Node.js 和 Python）生成，一共消耗 Artist 套餐的 117 积分，包括多跑的几次。useapi.net 是第三方 API，与 ACE Music 及其开发商 Timedomain 无关联。

模型与 API 的功能

每个请求生成两首歌，由 model 决定用哪个模型：

模型 model 用途 设置 每个请求的积分 我们实测的耗时
ACE Music v1 acemusic-v1（默认） 排名第一的人声模型：根据提示词或你的歌词生成歌曲，可演唱也可纯音乐 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 和读取乐谱，Creator 和 Artist 还能下载 WAV、MIDI 和 MusicXML
曲库、任务、账号 GET /music、/jobs、/accounts 账号的所有歌曲、运行中的任务、实时积分
MCP 服务器 /v1/acemusic/mcp 15 个供 AI 助手使用的工具

价格

ACE Music 按请求从你的 ACE Music 套餐中扣除它自己的积分，useapi.net 不按歌曲额外收费（截至 2026 年 11 月）：

请求 积分
在 ACE Music v1 或 v1.1 上生成两首歌 4
分轨，人声 + 伴奏 5，付费套餐
分轨，全部音轨 60，付费套餐
ACE-Step 歌曲的乐谱，首次读取 1
在 ACE-Step v1.5 XL 上生成两首歌 0，所有套餐
歌词和风格生成、上传、下载 我们测试中为 0

ACE Music 套餐包括：免费套餐每天 20 积分；Creator 每月 $9.90，含 1,000 积分；Artist 每月 $29，含 2,500 积分；按年付费则分别为每月 $7.90 和 $16.58。一首歌是半个请求，即 2 积分。API 概览中有同样的表格。

各套餐上一首歌的费用，最便宜的在左边（一个请求生成两首歌，所以一首歌是一个请求积分的一半；截至 2026 年 11 月）：

模型 免费
每天 20 积分		 Artist $16.58/月
每月 2,500 积分，年付		 Creator $7.90/月
每月 1,000 积分，年付		 Creator $9.90/月
每月 1,000 积分		 Artist $29/月
每月 2,500 积分
ACE Music v1、v1.1
一首歌		 $0 / 2 积分
每天 10 首		 $0.013 / 2 积分
每月 1,250 首		 $0.016 / 2 积分
每月 500 首		 $0.020 / 2 积分
每月 500 首		 $0.023 / 2 积分
每月 1,250 首
分轨
人声 + 伴奏		 付费套餐 $0.033 / 5 积分 $0.040 / 5 积分 $0.050 / 5 积分 $0.058 / 5 积分
分轨
全部音轨		 付费套餐 $0.40 / 60 积分 $0.47 / 60 积分 $0.59 / 60 积分 $0.70 / 60 积分
ACE-Step 乐谱
首次读取		 $0 / 1 积分 $0.007 / 1 积分 $0.008 / 1 积分 $0.010 / 1 积分 $0.012 / 1 积分
ACE-Step v1.5 XL
一首歌		 $0 / 0 积分 $0 / 0 积分 $0 / 0 积分 $0 / 0 积分 $0 / 0 积分

与其他用代码调用这些模型的方式相比：

模型 useapi.net 其他 API
ACE Music v1、v1.1 Preview Artist 年付低至每首 $0.013，用免费套餐每天的 20 积分则为 $0 没有：ACE Music 没有为它们提供公开 API
ACE-Step v1.5 XL 所有 ACE Music 套餐上都是 $0，免费套餐也一样 第三方 acestep.io API 每首约 $0.14，且需要其每月 $49 的 Studio 套餐

在任何 ACE Music 套餐上（包括免费套餐），ACE-Step v1.5 XL 歌曲都不消耗积分；而第三方 acestep.io 的 API 需要其每月 $49 的 Studio 套餐（每月约 360 首，每首约 $0.14，截至 2026 年 11 月）。

开始使用

每月 15 美元的订阅即可使用 useapi.net 上的所有 API：一个 Token，所有服务。每个服务最多绑定 3 个你自己的账号，useapi.net 负责 REST 接口、负载均衡和轮询。需要更多账号？每增加一个订阅每月 10 美元，每个服务再多 3 个账号。

订阅 — 每月 15 美元 用加密货币支付

没有国际信用卡？可以用加密货币订阅（加密货币付款不退款）。价格与批量方案见订阅页面。用 Stripe 付款，首次购买 14 天内、且成功生成少于 50 次可全额退款。已经订阅？请在 Stripe 客户门户 修改数量，无需重新购买。

如何用 curl 生成歌曲

你需要一个 useapi.net API Token（见 Setup useapi.net），以及一个有邮箱和密码的 ACE Music 账号。一份每月 $15 的订阅涵盖 useapi.net 的所有 API 和 3 个 ACE Music 账号。免费的 ACE Music 账号也可以：它每天有 20 积分，而 ACE-Step 歌曲不需要积分。命令中用 jq 读取 JSON。

添加你的 ACE Music 账号

导出 Token，然后添加一次账号即可。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" }'

用 Continue with Google 或手机号注册的账号需要先设置密码，见 Setup ACE Music，它也可以替你添加账号。

根据提示词生成歌曲

用你自己的话描述这首歌。ACE Music 会写出风格、歌词和标题，然后生成两首歌。下面就是本页第一首歌背后的原始请求：

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。大约每 10 秒轮询一次 GET /jobs/jobid。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 供网页播放器使用的直链，在 playUrlExpires 之前有效（约一小时）：有些浏览器（例如 Brave）会拦截 audioUrl 背后的重定向。
  • 翻唱、混搭、分轨、下载和乐谱都使用 songId。它标明了歌曲所在的账号，所以这些调用会在该账号上运行。
  • model 是你请求的模型，modelUsed 是实际运行的模型（见混搭）。kind 为 original、cover、edit、mashup 或 upload，score 表示这首歌是否已经有乐谱。
  • ACE Music 未能生成的歌曲为 status: "failed"，error 中是 ACE Music 给出的原因；积分退回时会带 refunded: true。

下面是这两首歌中的第一首：

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 会收到一次已完成任务的 POST，其中带有你的 replyRef

我们不带 async 的 ACE-Step 请求在 37 秒后返回，webhook 在歌曲完成 12 秒后到达。任务在 7 天内都可以读取，开始 30 分钟后仍在运行的任务会以 504 失败。async-webhooks/ 演示了全部三种方式，并附带一个小型 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}]}'

演唱你自己的歌词

用 style 和 lyrics 代替 prompt，ACE Music 就会按你的风格唱出你的歌词：

字段 作用 限制
style 曲风、乐器、情绪、速度和人声 1,000 个字符，ACE-Step 为 512
lyrics 你的歌词，任何语言，可用 [Verse]、[Chorus]、[Bridge] 标签 5,000 个字符，ACE-Step 为 2,000
title 歌曲标题。不填则由 ACE Music 命名 80 个字符
instrumental true 表示不要人声。只发 style 不发 lyrics 效果相同  
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 先规划整首歌，数值低时更有创意，高时更稳定

我们的三首 ACE-Step 歌曲（一首 3/4 拍华尔兹、一首 6/8 拍吉格舞曲和一首 174 bpm 的 drum and bass）时长都与请求完全一致（示例）。这些选项只在 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 用新的 lyrics 重写 start 到 end 秒之间的部分，其余保留
mashup 2 或 3 首 acemusic-v1.1 4 把多首歌合成一首新歌，见下文

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/。

混搭两首或三首歌

mode: "mashup" 把同一账号上的 2 或 3 首歌合成一首，除非你发送了 lyrics，否则会组合它们的歌词。audioInfluence（0 到 100，默认 60）决定贴近原曲的程度。混搭需要读取这些歌曲，所以即使你请求的是 v1，它也会在 ACE Music v1.1 Preview 上运行，和 ACE Music 网站一样：我们的“Harbor Fiesta”显示 "model": "acemusic-v1" 和 "modelUsed": "acemusic-v1.1"，积分按实际运行的模型计算。在 v1 上请求的 cover、在 ACE-Step 上带多个参考的提示词，以及有时带参考歌曲的提示词，也会这样。脚本：mashup/。

用你自己的音频和图片引导歌曲

POST /files 以原始请求体接收文件，并带上对应的 Content-Type：

上传 格式 上限 返回 用途
音频 MP3、WAV、FLAC、OGG、M4A、AAC 100 MB，8 分钟 一个 songId：一首曲库歌曲，其歌词、风格、速度和旋律由 ACE Music 转录 作为提示词最多 3 个 references 之一，或作为要翻唱、重混、编辑或混搭的歌曲
图片 JPEG、PNG、WebP 10 MB 一个 mediaId 作为提示词最多 3 张 images 之一：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）。一张跳舞机器人的图片变成了一首 drum and bass，唱的是它青绿色的绒毛和橙色的高帮鞋。两者都在示例中。上传会计入账号的额度：免费套餐 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 分钟，得到 9 条音轨：主唱、和声、鼓、贝斯、吉他、键盘、弦乐、合成器和音效（试听）。分轨链接有效期 24 小时，过期后重新读取歌曲即可拿到新链接。用同一模式再次拆分同一首歌会立即返回，不扣积分。

下载 MP3、WAV、MIDI 和 MusicXML

ACE Music 在第一次请求时才生成 WAV、MIDI 和 MusicXML：API 最多等待一分钟，然后返回 202，一分钟后再调用即可。“Paper Lanterns”的三种格式都在几秒内就绪：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 一页歌曲，最新的在前，用 next 获取下一页。有多个账号时需要 email。超过 7 天的任务的歌曲也在这里
GET /music/songId 一首歌，带新的链接，拆分过的还带分轨
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 订阅可以连接 3 个 ACE Music 账号，总计最多 100 个。不带 email 的请求会发到一个状态正常且有空闲名额的账号，指定了歌曲、上传或图片的请求则在它们所在的账号上运行。每个账号最多同时运行 maxJobs 个请求，默认为 4，这是 ACE Music 自己的限制。所有账号都忙时，API 返回 429 和 Retry-After；如果 ACE Music 拒绝了密码，该账号会一直返回 596，直到你重新添加它。

GET /accounts/email 实时读取套餐、积分和各项积分费用；只带 email 和 maxJobs 调用 POST /accounts，则只修改 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）

同样的功能也以托管 MCP 服务器的形式提供，共 15 个工具，从歌曲、翻唱和混搭到分轨、乐谱和上传。ACE Music 自己没有公开的 MCP 集成（截至 2026 年 11 月）。在 Claude Code 中只需一条命令：

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 中使用。然后直接用自然语言提出要求：“Write lyrics about a cat who loves rainy days and sing them as acoustic indie folk on ACE Music v1”。

用脚本批量生成

acemusic-api GitHub 仓库为每个功能提供一个示例，上面各节都有链接：一个 Node.js 脚本和一个对应的 Python 版本，无需安装任何依赖。每个脚本从你编辑的 prompts.json 读取请求，最多同时运行 4 个，轮询任务，并把两首歌、它们的封面、任务记录以及记录积分消耗的 ledger.jsonl 保存到 output/ 文件夹中。

你需要 Node.js 21 或更高版本，或 Python 3.8 或更高版本。--only 3 运行下面的第三个提示词，这是一首不消耗积分的 ACE-Step 歌曲，所以免费账号也能运行：

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 账号上生成的，取的是每个请求两首歌中的第一首。除非我们指定了标题，否则标题都由 ACE Music 命名；时间从发出请求算到两首歌都完成；调用中的 id 是虚构的。

根据图片生成歌曲

输入一张图片和一句风格描述，输出两首完整的歌。我们上传了这张跳舞的机器人吉祥物照片，要求一首 drum and bass；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”在上面的完整流程中。另外两个提示词，分别用另外两个模型：

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
  }'

你自己的歌词

我们自己写的两段主歌、一段预副歌、一段桥段和一段尾奏，请求时长 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”改成 deep house。我们没有发送标题，所以 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
  }'

一次混搭三首歌：“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 账号上通过 REST 运行 ACE Music v1、ACE Music v1.1 Preview 和 ACE-Step v1.5 XL，支持翻唱、混搭、分轨和 MIDI。ACE Music v1 和 v1.1 没有自己的公开 API（截至 2026 年 11 月），所以 useapi.net 是用代码调用它们的唯一途径。ACE Music 自己的 API 运行的是较旧的 ACE-Step v1.5，并且已暂停新的 API Key 注册。

有免费的 ACE-Step API 吗？ 通过 useapi.net 就有：在任何 ACE Music 套餐上（包括免费套餐），ACE-Step v1.5 XL 歌曲都不消耗积分，并支持速度、调性、拍号和时长设置，以及重混和编辑。第三方 acestep.io 只在其每月 $49 的 Studio 套餐中提供 ACE-Step API，每首约 $0.14（截至 2026 年 11 月）。

通过 API 生成一首 ACE Music v1 歌曲要多少钱？ 通过 useapi.net，一首 ACE Music v1 歌曲消耗你 ACE Music 套餐的 2 积分：Artist 年付为 $0.013，Artist 月付为 $0.023，不按歌曲额外收费。ACE Music v1 没有通过任何公开 API 出售（截至 2026 年 11 月），所以用你套餐的积分是从代码中按首为它付费的唯一方式。见价格。

有 ACE Music MCP 服务器吗？ 通过 useapi.net 就有：托管的 ACE Music MCP 服务器提供 15 个工具，让 Claude 应用、ChatGPT、Claude Code 和 Cursor 在你的 ACE Music 账号上生成歌曲、翻唱、混搭和分轨，无需安装任何东西。ACE Music 自己没有提供公开的 MCP 集成（截至 2026 年 11 月）。

结语

一次 POST 就能在人声排行榜第一的模型上生成两首歌，ACE-Step 歌曲不花一分钱，每首歌都可以在下一次调用中继续做成翻唱、混搭、分轨或 MIDI 文件。克隆 acemusic-api 仓库，在免费账号上用 --only 3 运行 songs-from-prompt/，所有选项见 POST /music。

有问题欢迎加入我们的 Discord 服务器 或 Telegram 频道。