Taoyoutx API Overview

Welcome to the Taoyoutx API docs. These docs explains all of the features and controls of the Taoyoutx API in detail.

By using the Taoyoutx API, you agree that you have read, understood, and agree to the Taoyoutx API Terms of Use.

Overview

Right now, the Taoyoutx API includes features from Taoyoutx's Stems page. You can separate any song into its main stems - vocals, drums, bass, melodies, and instrumental (a combination of drums, bass, and melodies). You also receive midi of each stem except for drums, the chord progression as txt and midi, and advanced key and tempo detection.

Usage of the Taoyoutx API requires a Taoyoutx Plus subscription, which costs $10/mo or $100/yr. Your subscription pays for your first $10 of API usage every month.

Concepts

Files

All files used with the Taoyoutx API are stored on Taoyoutx's fast and secure cloud storage - you don't need to store anything yourself. In order to upload and download files, you ask the Taoyoutx API for presigned URLs. A presigned download URL gives you temporary read access to a specific file via a GET request and a presigned upload URL gives you temporary write access to a specific location via a PUT request.

Assets

Assets are documents in Taoyoutx's database that describe a file in Taoyoutx's storage. After you upload a file via a presigned URL, you create a corresponding asset, and from then on you exclusively use the asset in communication with the Taoyoutx API.

Tasks

Tasks are documents in Taoyoutx's database that describe a processing job such as stem separation. For every job you request, a task is created. You can ask the Taoyoutx API for an updated version of a task at regular intervals to see its latest status and details.