在 Python 里做 stem 分离。

Default to sync (StemSplitter) — that's what the 12-line hello world uses, and it's what fits naturally inside a Django view or a Celery task. Switch to AsyncStemSplitter when you're already on FastAPI, Starlette, or asyncio in a notebook: the method names match (await client.submit, await client.wait, await client.download), so swapping costs one import + one await per call.

Yes — both are first-class. The Webhooks section above ships runnable handlers for each: FastAPI uses async def webhook(request: Request) with verify_signature; Flask uses a sync @app.post route. Both verify HMAC-SHA256 with one import (from aistemsplitter import verify_signature) and unpack presigned stem URLs from the JSON body without extra parsing.

Standard tooling: `python -m venv .venv && source .venv/bin/activate && pip install aistemsplitter` for venv; `poetry add aistemsplitter` for Poetry; `uv add aistemsplitter` for uv. The package is pure-Python wheels (no native compilation), so installation completes in seconds on every platform — no pyenv shim, no FFmpeg pre-step, no GPU driver.

Yes. We expose the same model file the open-source community trusts — htdemucs_ft, plus htdemucs and htdemucs_6s — so output is bit-comparable to a local Demucs run with the same model + same input, modulo our managed inference settings (batch size, precision). Pass model='htdemucs_6s' on submit when you need guitar and piano stems.

Drop straight to /developers/api. The SDK is a thin typed wrapper over the same REST endpoints the curl quickstart calls, so the auth header (Authorization: Bearer ast_live_…), the webhook signature scheme (HMAC-SHA256 in aistemsplitter-signature), and the response shapes are identical. You can mix-and-match — call submit via the SDK, fetch status via raw httpx for a custom retry policy.

Two strategies. (1) Use webhooks — set webhook_url on submit and skip the polling loop entirely; the API posts results when the job finishes regardless of duration. (2) For files larger than 50 MB, call client.presign_upload() to get a direct-to-storage URL, upload via httpx multipart, then submit with the returned audio_url instead of streaming through our gateway.

默认用 sync（StemSplitter）——12 行 hello world 用的就是它，也自然适合 Django view 或 Celery task。当你已经在 FastAPI、Starlette 或 notebook 里的 asyncio 环境中时，再切换到 AsyncStemSplitter：method names 保持一致（await client.submit、await client.wait、await client.download），所以替换成本只有一个 import 加每次调用一个 await。

可以——两者都是 first-class。上方 Webhooks 部分为每个框架提供可运行 handler：FastAPI 使用 async def webhook(request: Request) 搭配 verify_signature；Flask 使用 sync @app.post route。两者都通过一个 import（from aistemsplitter import verify_signature）验证 HMAC-SHA256，并从 JSON body 中解包 presigned stem URLs，无需额外解析。

使用标准工具即可：venv 用 `python -m venv .venv && source .venv/bin/activate && pip install aistemsplitter`；Poetry 用 `poetry add aistemsplitter`；uv 用 `uv add aistemsplitter`。这个 package 是 pure-Python wheels（无需 native compilation），所以每个平台上都能几秒完成安装——不需要 pyenv shim、不需要 FFmpeg 预步骤，也不需要 GPU driver。

会。我们暴露的是开源社区信任的同一个模型文件——htdemucs_ft，以及 htdemucs 和 htdemucs_6s——所以在相同模型和相同输入下，输出可以与本地 Demucs 运行结果做 bit-comparable 对比，差异只来自我们的 managed inference settings（batch size、precision）。当你需要 guitar 和 piano stem 时，在 submit 时传 model='htdemucs_6s'。

直接切到 /developers/api。SDK 只是同一套 REST endpoints 上的 thin typed wrapper，也就是 curl quickstart 调用的同一套接口，所以 auth header（Authorization: Bearer ast_live_…）、webhook signature scheme（aistemsplitter-signature 中的 HMAC-SHA256）和 response shapes 都完全一致。你可以混用——用 SDK submit，用 raw httpx fetch status 来实现自定义 retry policy。

两种策略。1）使用 webhooks——submit 时设置 webhook_url，完全跳过轮询循环；无论时长多久，API 都会在 job 完成后 POST 结果。2）对于大于 50 MB 的文件，调用 client.presign_upload() 获取 direct-to-storage URL，通过 httpx multipart 上传，然后用返回的 audio_url submit，而不是把文件流经我们的 gateway。