变更日志
本页面记录所有会影响客户端的变更。建议订阅。
为什么这个页面重要：上游引擎会调整模型版本与返回格式。 引擎一改版，没跟进的客户端会直接断掉——不是报错，是静默拿到空结果。 这里是唯一能提前知道的地方。
2026-10-23 · v1.0.0 · 首次上线
新增
GET /v1—— 健康检查，无需认证POST /v1/music/generate—— 创建生成任务GET /v1/music/tasks/{task_id}—— 查询任务GET /v1/credits—— 查询积分
行为约定
- 状态统一为
PENDING/SUCCESS/FAILED三种 - 幂等：
x-idempotency-key头，重复提交返回同一任务 - 错误格式：
{"error":{"code":…,"message":…,"detail":…}} - 上游错误完整透传
已知问题
| 影响 | 说明 | 状态 |
|---|---|---|
| 高 | MiniMax 上游账户余额不足，生成任务会失败并自动退还积分 | 待充值 |
| 中 | MiniMax 免费降级模型已停用，降级链当前无效 | 待修复 |
| 中 | KIE / Mureka 引擎尚未接入网关 | 待接入 |
| 低 | 网页回调（webhook）未实现，当前需轮询 | 规划中 |
这些是如实记录，不是营销文案。已知问题会随修复在下方追加记录。
变更约定
本项目遵循语义化版本：
| 版本 | 含义 | 客户端应对 |
|---|---|---|
| 主版本 | 破坏性变更 | 必须修改代码 |
| 次版本 | 新增功能，向后兼容 | 无需改动 |
| 修订版本 | 修复与文案调整 | 无需改动 |
字段废弃会先标记为 deprecated 并保留至少一个次版本，
再于下一个主版本移除。
kemo Music API · 聚合多引擎音乐生成 · 文档随实现同步更新
最后更新：2026-10-23 · 有问题请联系站点管理员
最后更新：2026-10-23 · 有问题请联系站点管理员