v1
服务在线
变更日志 返回 kemo

kemo Music API

一套接口，接入多个 AI 音乐生成引擎。统一契约、统一状态、统一计费。

当前状态：服务已上线并通过完整实测。生成功能的上游（MiniMax）账户余额不足， 充值后即可正常生成。详见 变更日志。

它解决什么

MULTI-BACKEND
多引擎自动路由

按优先级依次尝试各引擎，仅在「可重试类故障」（限流 / 5xx / 余额不足）时降级。 参数错误或内容审核拒绝不降级——换引擎也过不了，只会白扣一次费。

UNIFIED STATE
状态归一

无论上游返回什么格式，客户端只看到三种状态：PENDING / SUCCESS / FAILED。 不用为每个引擎各写一套解析。

IDEMPOTENT
幂等保护

传 x-idempotency-key，重复提交返回同一个任务，不重复扣费。 并发场景下由数据库唯一约束兜底。

OBSERVABLE
成本可见

每个响应都带 cost 与 backend——实际命中了哪个引擎、扣了多少积分，一目了然。

接口一览

方法路径说明认证
GET/v1健康检查，返回服务信息不需要
POST/v1/music/generate创建音乐生成任务需要
GET/v1/music/tasks/{task_id}查询任务状态与结果需要
GET/v1/credits查询积分余额与用量需要

Base URL

https://kemo.net.cn/functions/v1/kemo-music-api

两个域名指向同一套服务，kemo.ink 与 kemo.net.cn 均可访问， 国内访问建议用 kemo.net.cn（直连境内节点，延迟约 0.1 秒）。

第一个请求

curl -X POST "https://kemo.net.cn/functions/v1/kemo-music-api/v1/music/generate" \
  -H "Authorization: Bearer kemo_你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "一首宁静的原声吉他旋律配柔和人声，民谣风格",
    "lyrics": "[Verse]\n晚风穿过旧巷口\n[Chorus]\n灯火还亮着\n"
  }'

完整说明见 快速开始。

kemo Music API · 聚合多引擎音乐生成 · 文档随实现同步更新
最后更新：2026-10-23 · 有问题请联系站点管理员