APIドキュメント
Nebulux API
シンプルなREST APIでマスタリングを自動化
クイックスタート
1APIキー発行
設定ページ でAPIキーを生成してください。
2マスタリングリクエスト
curl -X POST "https://api.nebulux.io/v1/mastering" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: multipart/form-data" \
-F "[email protected]" \
-F "preset=balanced" \
-F "output_format=mp3"3結果確認
処理完了後、download_urlからマスタリングファイルをダウンロードできます。
認証
すべてのAPIリクエストにはAuthorizationヘッダーが必要です。
Authorization: Bearer YOUR_API_KEYエンドポイント
POST/mastering
新規マスタリング作業を作成
パラメータ
| 名前 | タイプ | 必須 | 説明 |
|---|---|---|---|
file | File | 必須 | オーディオファイル (MP3, WAV, FLAC, AAC, OGG, M4A) |
preset | string | 任意 | bright | smooth | balanced (デフォルト: balanced) |
output_format | string | 任意 | mp3 | wav | flac (デフォルト: mp3) |
レスポンス例
{
"job_id": "mst_abc123",
"status": "processing",
"created_at": "2024-01-15T10:30:00Z"
}GET/mastering/:job_id
マスタリング作業のステータスを取得
パラメータ
| 名前 | タイプ | 必須 | 説明 |
|---|---|---|---|
job_id | string | 必須 | 作業ID（URLパラメータ） |
レスポンス例
{
"job_id": "mst_abc123",
"status": "completed",
"progress": 100,
"download_url": "https://...",
"created_at": "2024-01-15T10:30:00Z",
"completed_at": "2024-01-15T10:31:00Z"
}GET/credits
クレジット残高を取得
レスポンス例
{
"credits": 15,
"used_this_month": 5
}GET/mastering/history
マスタリング作業履歴
パラメータ
| 名前 | タイプ | 必須 | 説明 |
|---|---|---|---|
limit | number | 任意 | 取得数 (デフォルト: 20, 最大: 100) |
offset | number | 任意 | 開始位置 (デフォルト: 0) |
レスポンス例
{
"jobs": [
{
"job_id": "mst_abc123",
"original_filename": "track.wav",
"preset": "balanced",
"status": "completed",
"created_at": "2024-01-15T10:30:00Z"
}
],
"total": 42,
"limit": 20,
"offset": 0
}Rate Limits
- マスタリングリクエスト: 分間10回
- ステータス確認: 分間60回
- エンタープライズプラン: 制限なし