당신의 스택에 맞는 SDK를 선택하세요
작업을 제출하고, 한 번 폴링하고, 6개 스템 받기
표면적을 증명하는 12줄입니다. 분리 작업을 제출하고, job id를 받고, 한 번 폴링한 뒤 vocals, drums, bass, guitar, piano, other를 받으세요. 모든 SDK에서 동일하게 실행되는 htdemucs_ft 분리입니다. 만료되지 않는 크레딧 팩에서 입력 오디오 분당 과금됩니다(볼륨에 따라 분당 $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, 팀의 나머지를 위한 노코드 경로
엔지니어만 사용자가 되는 경우는 드뭅니다. 같은 스템 분리기 API를 n8n, GitHub Actions, 컨테이너, Pipedream workflow에 넣어 ops, 콘텐츠, CI가 모두 하나의 벤더에서 실행되게 하세요.
개발자가 설치 전에 묻는 질문
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 3 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.
어떤 SDK를 설치해야 하나요 — Node, Python, 아니면 curl?
서비스가 이미 실행되는 언어를 선택하세요. Node와 Python은 one-call helpers(waitForSplit, verify_signature)와 전체 메서드 자동완성을 갖춘 typed clients를 제공합니다. 프로토타입을 만들거나 shell에서 스크립팅한다면 curl도 같은 REST endpoints에서 동작합니다. Hosted API는 13개 배포 채널 모두에서 동일합니다 — 같은 job ids, 같은 webhooks, 같은 분당 과금입니다.
크레딧은 사용하지 않으면 만료되나요?
아니요. 크레딧 팩은 만료되지 않습니다. $6.99 / 50분, $15 / 150분, $39.99 / 500분을 구매하면 잔액은 사용할 때까지 계정에 남아 있습니다. 월 구독, rollover cap, 자동 갱신이 없습니다. 첫 3분은 카드 없이 무료이며, 팩 크기에 따라 분당 $0.08~$0.14로 과금됩니다.
어떤 모델을 사용하며, 요청에서 모델 이름을 지정할 수 있나요?
기본값은 htdemucs_ft(Demucs fine-tuned, 4-stem: vocals, drums, bass, other)입니다. 오픈소스 커뮤니티가 약 8.7 dB SDR로 벤치마크하는 것과 같은 모델 변형입니다. submit에서 model='htdemucs_6s'를 전달하면 guitar와 piano stems로 전환할 수 있습니다. 모든 SDK에서 모델 이름을 명시하므로 출력 품질을 로컬 Demucs 실행과 비교할 수 있습니다.
SDK나 inference를 self-host할 수 있나요?
SDK clients는 MIT-licensed이며 npm, JSR, PyPI, Maven Central, Packagist, LuaRocks, SPM, CocoaPods로 배포됩니다. 원하는 대로 fork하거나 vendor로 포함할 수 있습니다. Inference 자체는 api.aistemsplitter.com의 hosted API를 통해 관리형 GPU에서 실행됩니다. v1에는 on-prem inference image가 없지만, GHCR Docker image는 self-hosted orchestration을 위해 SDK를 감쌉니다.
rate limit은 무엇이고, 큰 파일은 어떻게 처리하나요?
동시 작업 수와 분당 요청 제한의 현재 숫자는 /developers/api에 있습니다(변동될 수 있어 여기에 고정하지 않습니다). 큰 업로드는 presignUpload(Node) / presign_upload(Python)를 호출해 direct-to-storage URL을 받으세요. SDK는 기본적으로 exponential backoff로 재시도를 처리합니다. 50 MB까지는 직접 업로드하고, 더 큰 파일은 multipart presigned URLs를 사용합니다.
계속 폴링하지 않고 결과를 받으려면 어떻게 하나요?
createSplit에 webhook_url을 전달하세요. 작업이 완료되면 API가 stem download links를 inline으로 담아 HMAC-SHA256-signed event를 URL로 POST합니다. 한 번의 SDK 호출(Node의 verifyWebhook, Python의 verify_signature)로 서명을 검증하세요. 각 언어별 quickstart의 Webhooks 섹션에는 실행 가능한 Express, Hono, FastAPI, Flask handlers가 있습니다.