Base URL
所有 API 接口使用以下 Base URL:Content-Type: application/json)。
身份认证
每个请求必须在Authorization 请求头中携带 AppKey:
sk-mm- 开头。你可以在控制台的 API Keys 页面创建和管理密钥。
响应格式
所有响应采用统一的数据信封格式:错误码
错误响应示例:
限流
触发限流时返回 HTTP429,并携带以下响应头:
异步工作流
大多数音乐生成接口是异步的:
推荐轮询间隔: 每 5 秒一次。大多数曲目在 30–120 秒内完成。
提示: 使用
callback_url 可完全避免轮询 — 服务器会在任务完成后主动 POST 结果到你的接口。
Webhook 回调
提供callback_url 后,任务完成或失败时服务器会发送 POST 请求。完整的 Payload 结构、签名验证和重试策略请参阅 Webhook 回调。
数据保留
生成的音乐文件会保存一段可配置的时长(默认 7 天)。到期后audio_url 和 image_url 将不可访问。expire_at 字段(Unix 毫秒时间戳)标示每个结果的过期时间。请求已过期的音乐 ID 将返回错误码 4005。