StemSplit API：AIステム分離をアプリに統合する

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

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

構築できるもの

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

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

YouTube動画を直接処理

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

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を受け取ります：

{
  "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キーを取得する — 新規アカウントにはテスト用の5分間無料が付きます。

---

仕組み

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

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

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によるカラオケジェネレーター

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行。

統合ガイド

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

技術リファレンス

認証

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxx

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

レート制限と制約

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

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

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

品質設定

料金

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

ドキュメント

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

よくある質問

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

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

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

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

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

---

構築を始める

1. アカウントを作成する
2. APIキーを生成する
3. ドキュメントを読む

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

APIキーを取得する →