|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桁のhex。

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セクションで詳しい情報をご確認ください。