|API Docs

API Documentation

使用 Masterify REST API 自动化您的母带处理工作流程。所有请求都需要头。

Base URLhttps://api.masterify.net

REST API · Webhook · Pro 及以上

快速开始

先从模板中心开始

我们提供 make.com 和 n8n 的入门 JSON 及分步指南。在阅读代码示例之前，先下载可导入的工作流进行测试。

打开模板中心查看推荐模板

包含的模板

Google Drive 上传检测 → 母带处理 → Slack 通知
Airtable 队列读取 → 母带处理 → Row 更新
表单上传收集 → 母带处理 → 客户邮件发送

认证

所有 API 请求都需要 Bearer 令牌认证。请在控制台设置页面创建 API 密钥。密钥格式: + 32 位十六进制。

curl -H "Authorization: Bearer aim_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"

各套餐 API 限制

套餐	API 密钥	频率限制	Webhooks
free	1 个	5 次/分钟	1
starter	3 个	30 次/分钟	5
pro	5 个	60 次/分钟	10
studio	10 个	120 次/分钟	∞

POST/api/v1/master

创建母带处理任务

上传音频文件并创建母带处理任务。文件须为 MP3/WAV/FLAC 格式，最大 50MB，不超过 10 分钟。

请求体multipart/form-data

名称	类型	必填	说明
file	`File`	Yes	音频文件 (MP3, WAV, FLAC)
platforms	`string`	Yes	逗号分隔的平台: spotify, apple_music, youtube, melon, soundcloud
genre	`string`	No	风格: kpop, edm, ballad, hiphop, pop, other (默认: other)
ai_service	`string`	No	AI 服务: suno, udio, elevenlabs, other (默认: other)
tier	`string`	No	母带处理级别: standard, premium (默认: standard)
webhook_url	`string`	No	任务完成时的回调 URL (per-job)
reference_file	`File`	No	参考音轨 (用于音色匹配)

响应201

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "platforms": ["spotify", "apple_music"],
  "credits_used": 1,
  "credits_remaining": 19
}

错误响应

所有错误以相同格式返回：

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "크레딧이 부족합니다."
  }
}

HTTP	代码	说明
400	FILE_TOO_LARGE	文件大小超过 50MB
400	UNSUPPORTED_FORMAT	仅支持 MP3、WAV、FLAC
400	FILE_TOO_LONG	文件超过 10 分钟
400	INVALID_PLATFORM	无效的平台
402	INSUFFICIENT_CREDITS	积分不足
429	CONCURRENT_LIMIT	超过并发处理上限
401	INVALID_API_KEY	无效的 API 密钥
429	RATE_LIMIT	请求频率超限

快速开始

3 步开始您的第一次母带处理。

创建 API 密钥

控制台 → 设置 → 创建 API 密钥

aim_live_a1b2c3d4...

请求母带处理

通过 POST /api/v1/master 上传文件

curl -X POST .../v1/master \
  -H "Authorization: Bearer ..." \
  -F "[email protected]" \
  -F "platforms=spotify"

下载结果

当 status=done 时下载

GET /api/v1/jobs/{id}/download

有疑问？落地页 API 部分查看更多信息。