Create Songs from Your Own Code

POST a prompt to /generation, poll the job, download the finished MP3 or WAV. Everything the TwoShot web app can do, exposed as REST.

The song-creation endpoint is the single most-used tool in the TwoShot API. You pass a prompt (plus optional lyrics, genre, tempo, key, style references) and get back a full song — vocals, instrumentation, arrangement, intro and outro included — typically in 60 to 120 seconds. It's the same pipeline the web app uses, so output quality matches what users see in Coproducer. Most integrations use it as the backend for a consumer app: a user types a description in your UI, you POST to TwoShot, poll until done, and hand back a pre-signed URL for playback. The shape is intentionally simple — one endpoint, one job object, one result URL — so your app layer stays thin. Advanced parameters (reference tracks, voice cloning, duration overrides) are available but optional. For high-volume integrations, we run per-tenant capacity so your jobs don't queue behind other users. Pricing is per-credit, and credits map to compute-time. A typical 3-minute song costs roughly the same whether you run 1 a day or 10,000 — the system scales horizontally.