跳转到主要内容

Base URL

所有 API 接口使用以下 Base URL:
所有请求和响应均为 JSON 格式(Content-Type: application/json)。

身份认证

每个请求必须在 Authorization 请求头中携带 AppKey:
AppKey 以 sk-mm- 开头。你可以在控制台的 API Keys 页面创建和管理密钥。
未携带有效 AppKey 的请求将返回 HTTP 401,错误码为 1002

响应格式

所有响应采用统一的数据信封格式:

错误码

错误响应示例:

限流

触发限流时返回 HTTP 429,并携带以下响应头:

异步工作流

大多数音乐生成接口是异步的:
任务状态: 推荐轮询间隔: 每 5 秒一次。大多数曲目在 30–120 秒内完成。 提示: 使用 callback_url 可完全避免轮询 — 服务器会在任务完成后主动 POST 结果到你的接口。

Webhook 回调

提供 callback_url 后,任务完成或失败时服务器会发送 POST 请求。完整的 Payload 结构、签名验证和重试策略请参阅 Webhook 回调

数据保留

生成的音乐文件会保存一段可配置的时长(默认 7 天)。到期后 audio_urlimage_url 将不可访问。expire_at 字段(Unix 毫秒时间戳)标示每个结果的过期时间。请求已过期的音乐 ID 将返回错误码 4005