♫音乐图形
GET API / v1

用一条 URL 生成音乐图片。直接放入 Anki、网页或 Markdown,缩放仍然清晰,也能生成练耳音频。

音名与键盘

逗号分隔,八度 0–8。S 升号、F 降号、o 还原、x 重升、8 重降。未写变音标记表示自然音;调号只影响记号显示。

生成结果

SVG
下载 SVG

接口约定

/v1/notes?type=keyboard&notes=C4,E4,G4 /v1/strings?type=fret&notes=1:3;3:0;6:
成功返回自包含 SVG;type=abc 返回纯文本。五线谱音使用全音符,所有音属于同一事件。

查看参数、限制与错误响应
接口参数默认值
/v1/notesnotes · typestaff,G,C
/v1/scoreabc(UTF-8 Base64URL)必填
/v1/audionotes · mode · bpm · duration · tuningchord;自动识别输入
/v1/stringsnotes · typetab

音符最多 64 个;弦号 1–32;品位 0–48;弦品位置最多 256 个。URL 最多 16 KiB,ABC 解码后最多 8 KiB,SVG 最多 1.5 MB。无效语法返回 400,语义或能力限制返回 422,过长 URL 返回 414,错误正文为 JSON。音频最多 30 秒,单次发声 0.05–10 秒,BPM 20–300,最多同时发声 64 个音高;另有计算量限制。

五线谱、键盘与音频中的裸音均表示自然音,调号不改变输入音高。五线谱省略与调号一致的变音记号,补上必要的还原等记号;音名拼写与等音异名保留用户写法。ABC 支持核心排版指令,外部文件、模块、脚本及资源请求均不开放。

本服务已部署为公开 Cloudflare Worker,可供 Anki 和其他客户端引用。接口内置一天的 Cloudflare 共享缓存。