Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.soundpiece.co/llms.txt

Use this file to discover all available pages before exploring further.

​
Welcome

Welcome to the Soundpiece API. The Soundpiece API gives you programmatic access to our audio generation, separation, and adaptation capabilities. Generate songs from lyrics, separate stems from a mix, cut audio to length — anything you can do in the Soundpiece app, you can do over HTTP.

​
What kind of API is this?

Soundpiece is an RPC-style API, similar in shape to Slack’s or Stripe’s APIs. Each endpoint is a named action like create.new_song or adapt.separate_stems. There are no resource hierarchies to learn — pick the action you want and call it. Three patterns hold across the whole surface:
  • PUT to submit, GET to poll. Every operation is asynchronous — you submit work and we return immediately with an id and status: "processing". You then call the same endpoint with GET (or wait for a webhook) until status is ready or failed. See Async operations.
  • idempotency_key makes retries safe. Every PUT takes a UUID you choose. Sending the same request twice with the same key returns the original response. The key is echoed back on every response and webhook payload so you can correlate work against your own records.
  • Signed URLs for downloads. When status is ready, each output carries a time-limited signed URL you can GET to download FLAC audio. No separate download endpoint; no extra auth on the URL.

​
What we offer

Song Generation

Produce full-length tracks from lyrics plus a text prompt or a reference track.

Instrumental Generation

Generate instrumentals from a prompt or a reference.

Sample Generation

Create short samples at a target duration, optionally designed to loop seamlessly.

Effects Generation

Generate single-shot effects — risers, impacts, transitions, foley.

Song Remixing

Produce fresh variations of an existing track with new lyrics and prompt.

Stem Separation

Separate a mixed track into vocals, drums, bass, and other stems.

Auto Cut-Down

Trim an existing track to a target duration at musically natural cut points.

​
Who this is for

  • 💻 Developers building music-driven apps and intelligent audio tools
  • 🎥 Content creators producing sound for social media
  • 🎚️ Music producers generating or remixing audio at scale
  • 🧪 Researchers experimenting with generative audio models
  • 📚 Music libraries making their music adaptive or looking for tagging solutions
  • 🏢 Digital agencies creating branded or campaign-specific music

​
Get started

Head to the Quickstart for a complete end-to-end example, or jump to one of the core concepts:
  • Authentication — API keys, signing secrets, key rotation.
  • Async operations — the submit-poll-download lifecycle every endpoint follows.
  • Webhooks — push notifications when operations complete.
  • Errors — HTTP error responses and operation-level failure codes.
  • Rate limits — 429 handling and how capacity is managed.
  • Versioning — what’s stable, what changes, how deprecations work.

​
Support

If you spot a bug, need help with an integration, or have feedback, write to business@soundpiece.co.uk.