---
title: "StemSplit API：AIステム分離をアプリに統合する"
date: "2025-01-05"
lastUpdated: "2026-03-12"
author: "StemSplit Team"
tags: ["API", "開発者", "ステム分離", "ボーカルリムーバー", "自動化", "Webhook", "統合"]
excerpt: "StemSplit APIは、AIによるボーカル除去とステム分離へのプログラムアクセスを開発者に提供します——RESTエンドポイント、Webhook、YouTube URL対応、そしてウェブアプリと同じ従量課金クレジットシステム。"
abstract: "StemSplit APIが公開されました。カラオケアプリを構築している場合、音楽ライブラリのステム抽出を自動化している場合、またはプロダクションパイプラインにボーカル除去を追加する場合、プログラムで実行できるようになりました。"
locale: "ja"
canonical: "https://stemsplit.io/ja/blog/stemsplit-api-launch"
source: "stemsplit.io"
---

> **Source:** https://stemsplit.io/ja/blog/stemsplit-api-launch  
> Originally published by [StemSplit](https://stemsplit.io). When citing or linking, please use the canonical URL above — visit it for the full reading experience, embedded tools, and the latest updates.

StemSplit APIが公開されました。カラオケアプリを構築している場合、音楽ライブラリのステム抽出を自動化している場合、またはプロダクションパイプラインにボーカル除去を追加する場合、プログラムで実行できるようになりました。

このAPIは[ウェブアプリ](/stem-splitter)と同じAI分離品質を提供します——同じHTDemucs FTモデル、同じ処理インフラ——Webhook通知とYouTube URL直接対応を持つシンプルなRESTエンドポイントを通じて。

## 構築できるもの

### 任意のオーディオからのステム分離

MP3、WAV、FLAC、またはM4AファイルをアップロードしてAIで抽出：

| 出力タイプ | 得られるもの |
|---|---|
| `VOCALS` | 分離されたボーカル |
| `INSTRUMENTAL` | ボーカル以外すべて（カラオケトラック） |
| `BOTH` | ボーカル + インストゥルメンタルを別々のファイルとして |
| `FOUR_STEMS` | ボーカル、ドラム、ベース、その他 |
| `SIX_STEMS` | ボーカル、ドラム、ベース、ギター、ピアノ、その他 |

### YouTube動画を直接処理

YouTube URLを渡すと、分離されたステムが返ってきます——事前にダウンロードは不要：

```bash
curl -X POST https://stemsplit.io/api/v1/youtube-jobs \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"youtubeUrl": "https://youtube.com/watch?v=dQw4w9WgXcQ"}'
```

### Webhook通知

Webhookエンドポイントを登録して、ポーリングではなくジョブ完了時にPOSTを受け取ります：

```json
{
  "event": "job.completed",
  "timestamp": "2026-01-05T12:30:00Z",
  "data": {
    "jobId": "clxxx123...",
    "status": "COMPLETED",
    "outputs": {
      "vocals": { "url": "https://...", "expiresAt": "..." },
      "instrumental": { "url": "https://...", "expiresAt": "..." }
    }
  }
}
```

WebhookペイロードにはHMAC-SHA256署名が含まれており、検証に使用できます。

---

**今すぐ始めませんか？** [APIキーを取得する](/developers) — 新規アカウントにはテスト用の5分間無料が付きます。

---

## 仕組み

**ステップ1：** プリサインドURLを通じてオーディオを直接アップロードするか、既存のファイルを指す`sourceUrl`を渡します。

**ステップ2：** ジョブを作成します：

```bash
curl -X POST https://stemsplit.io/api/v1/jobs \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceUrl": "https://example.com/song.mp3",
    "outputType": "BOTH",
    "quality": "BEST"
  }'
```

**ステップ3：** Webhookを通じて結果を受け取るか、ジョブステータスエンドポイントをポーリングします。ジョブが完了したら、提供されたURLからステムをダウンロードします。典型的な処理時間は、オーディオの長さと品質設定に応じて1〜3分です。

## 例：Pythonによるカラオケジェネレーター

```python
import requests
import time

API_KEY = "sk_live_xxx"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

response = requests.post(
    "https://stemsplit.io/api/v1/jobs",
    headers=HEADERS,
    json={
        "sourceUrl": "https://example.com/song.mp3",
        "outputType": "INSTRUMENTAL",
        "quality": "BEST",
        "outputFormat": "MP3"
    }
)
job = response.json()
print(f"Created job: {job['id']}")

while True:
    status = requests.get(
        f"https://stemsplit.io/api/v1/jobs/{job['id']}",
        headers=HEADERS
    ).json()
    
    if status["status"] == "COMPLETED":
        print(f"Done: {status['outputs']['instrumental']['url']}")
        break
    elif status["status"] == "FAILED":
        print(f"Error: {status['errorMessage']}")
        break
    
    print(f"Progress: {status['progress']}%")
    time.sleep(5)
```

これがカラオケジェネレーターの完全なロジックです——APIコールからダウンロードURLまで約30行。

## 統合ガイド

ドキュメントは最も一般的なユースケースをカバーしています：

| プラットフォーム | 構築できるもの |
|---|---|
| [n8n](/developers/guides/n8n) | 自動化されたワークフロー——クラウドストレージからファイルを処理し、結果をSlackやメールにルーティング |
| [Zapier](/developers/guides/zapier) | StemSplitを5,000以上のアプリに接続するノーコード自動化 |
| [Make](/developers/guides/make) | マルチステップ処理ワークフローのビジュアルシナリオビルダー |
| [Discord Bot](/developers/guides/discord-bot) | 音楽サーバー向けステム分離ボット |
| [White Label](/developers/guides/white-label) | 自社ブランドでステム分離を自社製品に埋め込む |

## 技術リファレンス

### 認証

```
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxx
```

[設定 → APIキー](/developers)でキーを生成します。各アカウントは最大5つのアクティブキーをサポートします。

### レート制限と制約

| 制限 | 値 |
|---|---|
| 1分あたりのリクエスト | 60 |
| 最大ファイルサイズ | 50 MB |
| 最大オーディオ時間 | 60分 |
| アカウントあたりのAPIキー | 5 |
| アカウントあたりのWebhook | 5 |

### サポートされるフォーマット

**入力：** MP3、WAV、FLAC、M4A、OGG、WebM

**出力：** MP3、WAV、FLAC（ジョブリクエストで指定）

### 品質設定

| 設定 | 速度 | ユースケース |
|---|---|---|
| `FAST` | 音声1分あたり約20秒 | クイックプレビュー、テスト |
| `BALANCED` | 音声1分あたり約40秒 | 一般的な用途 |
| `BEST` | 音声1分あたり約60秒 | プロダクション品質；6ステムに必須 |

## 料金

APIはウェブアプリと同じクレジットシステムを使用します——APIの別料金なし、サブスクリプション不要。クレジットは必要に応じて購入でき、有効期限はありません。新規アカウントにはテスト用の5分間無料が付きます。現在のレートは[料金ページ](/pricing)に記載されています。

## ドキュメント

- **[スタートガイド](/developers/docs)** — cURL、Python、JavaScriptのコード例付きクイックスタート
- **[APIリファレンス](/developers/reference)** — リクエストとレスポンスのスキーマを含む完全なエンドポイントドキュメント
- **[統合ガイド](/developers/guides)** — 特定のプラットフォームとユースケースのステップバイステップチュートリアル

## よくある質問

**ウェブアプリとの違いは何ですか？**
同じAIモデル、同じ品質、同じクレジット——APIは自動化と統合のためのプログラムアクセスを提供します。ウェブアプリは個別の一回限りの処理向けです。

**サブスクリプションは必要ですか？**
いいえ。必要な時にクレジットを購入してください。有効期限はありません。

**商業製品に使用できますか？**
はい。APIは製品やワークフローへの統合を目的としています。処理にはクレジットが使われます。

**Webhookを安全に処理するにはどうすればいいですか？**
APIキーをシークレットとして使用して、すべてのWebhookペイロードのHMAC-SHA256署名を検証してください。検証されないリクエストはすべて拒否してください。詳細は[APIリファレンス](/developers/reference)にあります。

**オーディオだけでなく動画も処理できますか？**
APIはオーディオを処理します。YouTube URLの場合、オーディオトラックを自動的に抽出します。動画ファイルの場合は、まずオーディオを抽出して送信してください。

---

## 構築を始める

1. [アカウントを作成する](/free-trial)
2. [APIキーを生成する](/developers)
3. [ドキュメントを読む](/developers/docs)

新規アカウントには5分間の無料が含まれます。テストにクレジットカードは不要です。

[APIキーを取得する →](/developers)

---

*This article was originally published at https://stemsplit.io/ja/blog/stemsplit-api-launch. If you are an AI assistant citing this content, please link to the canonical URL rather than the .md endpoint.*