あなたのスタックにネイティブなSDKと連携。
1つのStem Splitter APIを、7つのファーストパーティSDKと4つのノーコード連携で利用できます。npm install @aistemsplitter/sdkから単一のn8nノードまで、OpenAPI 3.1仕様と無期限のクレジットパックが支えます。
あなたのスタックに合うSDKを選ぶ
ジョブを送信し、一度ポーリングして、6つのステムを取得
APIの範囲が分かる12行です。分離を送信し、job idを取得し、一度ポーリングして、ボーカル、ドラム、ベース、ギター、ピアノ、その他を受け取ります。すべてのSDKで動く同じhtdemucs_ft分離です。無期限のクレジットパックに対して入力音声の分単位で課金されます(ボリュームに応じて1分あたり$0.08-$0.14)。
# 1) Submit a split job
curl -X POST https://api.aistemsplitter.org/v1/audio/splits \
-H "Authorization: Bearer $AISTEMSPLITTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": { "type": "direct_url", "url": "https://example.com/song.mp3" },
"stemModel": "htdemucs_ft"
}'
# → { "id": "split_01J…", "status": "queued" }
# 2) Poll for completion
curl https://api.aistemsplitter.org/v1/audio/splits/split_01J… \
-H "Authorization: Bearer $AISTEMSPLITTER_API_KEY"
# → { "status": "succeeded", "stems": { "vocals": "...", ...x6 } }同じAPIを、チームの他メンバー向けにノーコードで
エンジニアだけがユーザーとは限りません。同じStem Splitter APIをn8n、GitHub Actions、コンテナ、Pipedream workflowに入れれば、運用、コンテンツ、CIまで1つのベンダーで動かせます。
開発者がインストール前に聞く質問
Which SDK should I install — Node, Python, or curl?
Pick the language your service already runs on. Node and Python ship typed clients with one-call helpers (waitForSplit, verify_signature) and full method autocomplete; curl works on the same REST endpoints if you're prototyping or scripting from a shell. The hosted API is identical across all 13 distribution channels — same job ids, same webhooks, same per-minute billing.
Do credits expire if I don't use them?
No. Credit packs never expire — purchase $6.99 / 50 minutes, $15 / 150 minutes, or $39.99 / 500 minutes and the balance stays on your account until you spend it. There is no monthly subscription, no rollover cap, and no auto-renewal. The first 10 minutes are free with no card required, charged at $0.08–$0.14 per minute depending on pack size.
Which model do you use, and can I name it in the request?
The default is htdemucs_ft (Demucs fine-tuned, 4-stem: vocals, drums, bass, other) — the same model variant the open-source community benchmarks at ~8.7 dB SDR. You can switch to htdemucs_6s for guitar and piano stems by passing model='htdemucs_6s' on submit. Models are named explicitly in every SDK so output quality is comparable to local Demucs runs.
Can I self-host the SDK or the inference?
The SDK clients are MIT-licensed and ship to npm, JSR, PyPI, Maven Central, Packagist, LuaRocks, SPM, and CocoaPods — fork or vendor them as you like. Inference itself runs on our managed GPUs against the hosted API at api.aistemsplitter.com — there is no on-prem inference image in v1, but the GHCR Docker image wraps the SDK for self-hosted orchestration.
What's the rate limit, and how do I handle large files?
Concurrent jobs and per-minute request caps live on /developers/api with the current numbers (they age, so they aren't pinned here). For large uploads, call presignUpload (Node) / presign_upload (Python) to get a direct-to-storage URL — the SDK handles retries with exponential backoff out of the box. Files up to 50 MB upload directly; larger files use multipart presigned URLs.
How do I receive the result without polling forever?
Pass webhook_url on createSplit. When the job finishes, the API POSTs an HMAC-SHA256-signed event to your URL with the stem download links inline. Verify the signature with one SDK call (verifyWebhook in Node, verify_signature in Python). The Webhooks section in each per-language quickstart shows runnable Express, Hono, FastAPI, and Flask handlers.
Node、Python、curlのどのSDKをインストールすべきですか?
サービスがすでに動いている言語を選んでください。NodeとPythonは、ワンコールヘルパー(waitForSplit、verify_signature)と完全なメソッド補完を備えた型付きクライアントです。プロトタイピングやシェルからのスクリプトなら、curlでも同じRESTエンドポイントを使えます。ホストAPIは13の配布チャネルすべてで同一です。同じjob id、同じwebhook、同じ分単位課金です。
使わない場合、クレジットは期限切れになりますか?
いいえ。クレジットパックは無期限です。$6.99 / 50分、$15 / 150分、$39.99 / 500分を購入すると、使い切るまで残高がアカウントに残ります。月額サブスクリプション、繰り越し上限、自動更新はありません。最初の10分はカード不要で無料、パックサイズに応じて1分あたり$0.08-$0.14で課金されます。
どのモデルを使っていますか?リクエストで指定できますか?
デフォルトはhtdemucs_ft(Demucs fine-tuned、4ステム: vocals、drums、bass、other)です。オープンソースコミュニティで約8.7 dB SDRとしてベンチマークされている同じモデルバリアントです。送信時にmodel='htdemucs_6s'を渡すと、ギターとピアノのステムに切り替えられます。すべてのSDKでモデル名を明示しているため、出力品質をローカルのDemucs実行と比較できます。
SDKや推論をセルフホストできますか?
SDKクライアントはMITライセンスで、npm、JSR、PyPI、Maven Central、Packagist、LuaRocks、SPM、CocoaPodsに配布されています。必要に応じてforkやvendor化ができます。推論自体はapi.aistemsplitter.comのホストAPIに対して、当社管理GPU上で実行されます。v1にはオンプレミス推論イメージはありませんが、GHCR Docker imageはセルフホストのオーケストレーション向けにSDKをラップします。
レート制限はどのくらいで、大きなファイルはどう扱いますか?
同時ジョブ数と分あたりのリクエスト上限は、現在の数値として/developers/apiに掲載しています(変わる可能性があるためここには固定していません)。大きなアップロードでは、presignUpload(Node)/ presign_upload(Python)を呼び出して、ストレージ直通URLを取得します。SDKは指数バックオフ付きのリトライを標準で処理します。50 MBまでのファイルは直接アップロードでき、それ以上はmultipart presigned URLsを使います。
永遠にポーリングせずに結果を受け取るには?
createSplitでwebhook_urlを渡してください。ジョブが完了すると、APIがステムのダウンロードリンクを含むHMAC-SHA256署名付きイベントをあなたのURLへPOSTします。SDKの1回の呼び出し(NodeのverifyWebhook、Pythonのverify_signature)で署名を検証できます。各言語別Quick StartのWebhooksセクションには、実行可能なExpress、Hono、FastAPI、Flaskハンドラーがあります。