AIStemSplitter Python SDK

Official Python SDK for the AIStemSplitter public API.

• Homepage: https://aistemsplitter.org
• API docs: https://aistemsplitter.org/developers/api
• API base: https://api.aistemsplitter.org/v1
• OpenAPI: https://api.aistemsplitter.org/openapi.yaml

Installation

Install from PyPI:

pip install aistemsplitter

The conda-forge package is in review. After conda-forge publication:

conda install -c conda-forge aistemsplitter

Usage

import os
from aistemsplitter import AIStemSplitter

client = AIStemSplitter(os.environ["AISTEMSPLITTER_API_KEY"])

split = client.create_split({
    "input": {
        "type": "direct_url",
        "url": "https://example.com/song.mp3",
    },
    "stemModel": "6s",
})

print(split["id"])

Uploading local audio

with open("song.mp3", "rb") as handle:
    upload = client.upload_audio(
        handle.read(),
        filename="song.mp3",
        content_type="audio/mpeg",
    )

split = client.create_split({"input": upload["input"], "stemModel": "6s"})
result = client.wait_for_split(split["id"])

Development

PYTHONPATH=src python -m unittest discover -s tests

The conda-forge recipe skeleton lives in conda-forge/staged-recipes/recipes/aistemsplitter.