用一条 URL 生成音乐图片。直接放入 Anki、网页或 Markdown,缩放仍然清晰,也能生成练耳音频。
音名与键盘
生成结果
SVG接口约定
/v1/notes?type=keyboard¬es=C4,E4,G4 /v1/strings?type=fret¬es=1:3;3:0;6:
成功返回自包含 SVG;type=abc 返回纯文本。五线谱音使用全音符,所有音属于同一事件。
查看参数、限制与错误响应
| 接口 | 参数 | 默认值 |
|---|---|---|
| /v1/notes | notes · type | staff,G,C |
| /v1/score | abc(UTF-8 Base64URL) | 必填 |
| /v1/audio | notes · mode · bpm · duration · tuning | chord;自动识别输入 |
| /v1/strings | notes · type | tab |
音符最多 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 共享缓存。