Extract sections and separate stems

Use the client from request setup. These examples assume api, userAddress, and the returned songId are available. api includes the session token and selected account headers.

Extract a time range

const extracted = await api.post('/api/editing/extract', {
  songId, start: 15, end: 30,
});
const take = extracted.take;

The response is ready immediately with an inactive take. start and end are seconds on the selected source. Pass stemId to slice a particular stem. This does not bounce your live arrangement or effects. The extracted file begins at its own time zero; its provenance records where it belongs on the song timeline. Use candidate merge to place it correctly.

Separate instruments

const job = await api.post('/api/editing/separate', {
  songId, userAddress, stemType: 'all',
});

Choose a stem ID from /api/options, such as vocals, drums, bass, other or instrumental. Even though submission returns HTTP 200, the body can say pending or processing. Use the polling function from job handling.

// Save job before polling so your product can resume after a reload.
const path = `/api/editing/status/${encodeURIComponent(job.taskId)}?` +
  new URLSearchParams({
    songId: job.songId, userAddress, task: job.task,
    ...(job.stemId ? { stemId: job.stemId } : {}),
  });
const result = await pollJob(() => api.get(path));

Keep the returned taskId, songId, task, and optional stemId. A polling timeout stops your client from waiting; it does not cancel the job. On ready, use result.stems. Separation creates active takes for the returned tracks, with those stems initially muted. Reload the project. Your player can mute Master and unmute selected stems to audition them without doubling the same recording.

await api.patch(`/api/editing/mixer/${encodeURIComponent(stem.id)}`, {
  is_muted: false,
});

stem is one returned stem selected by your user. Mixer persistence does not render a new audio file.

Overview

Integration basics

Generate

Edit

Library and publishing

Extract sections and separate stems

Extract a time range

Separate instruments

​Extract a time range

​Separate instruments

Extract a time range

Separate instruments