Remix a song

import soundpiece

remix = soundpiece.run("create.remix_song", {
    "source": {"url": "https://example.com/audio/song.mp3"},
    "lyrics": "[Verse]\nMorning light on the harbour wall\n\n[Chorus]\nHappy birthday, Sam, this song is for you",
    "prompt": "acoustic folk, warm, female vocal",
    "n_variations": 2,
})

for number, output in enumerate(remix["outputs"], start=1):
    soundpiece.download(output["url"], f"remix-{number}.flac")
    print(f"Saved remix-{number}.flac")

import { run, download } from "./soundpiece.mjs";

const remix = await run("create.remix_song", {
  source: { url: "https://example.com/audio/song.mp3" },
  lyrics: "[Verse]\nMorning light on the harbour wall\n\n[Chorus]\nHappy birthday, Sam, this song is for you",
  prompt: "acoustic folk, warm, female vocal",
  n_variations: 2,
});

for (const [index, output] of remix.outputs.entries()) {
  await download(output.url, `remix-${index + 1}.flac`);
  console.log(`Saved remix-${index + 1}.flac`);
}

#!/usr/bin/env bash
# Submit, wait and download by hand. Needs curl, jq and uuidgen.
set -euo pipefail
API=https://api.soundpiece.co/v1
AUTH="Authorization: Bearer $SOUNDPIECE_API_KEY"

# 1. Submit. Sending this exact body again (same idempotency_key) is safe.
body=$(jq -n --arg key "$(uuidgen)" '{
  idempotency_key: $key,
  source: { url: "https://example.com/audio/song.mp3" },
  lyrics: "[Verse]\nMorning light on the harbour wall\n\n[Chorus]\nHappy birthday, Sam, this song is for you",
  prompt: "acoustic folk, warm, female vocal",
  n_variations: 2
}')
response=$(curl --silent --show-error --max-time 30 --request PUT "$API/create.remix_song" \
  --header "$AUTH" --header "Content-Type: application/json" --data "$body")
result=$(jq -e .remixed_song <<<"$response") || { echo "$response"; exit 1; }
id=$(jq -r .id <<<"$result")

# 2. Wait. Each call returns as soon as the work is finished, or after 20 seconds.
while [ "$(jq -r .status <<<"$result")" = processing ]; do
  response=$(curl --silent --show-error --max-time 30 "$API/create.remix_song?id=$id&wait=true" \
    --header "$AUTH")
  result=$(jq -e .remixed_song <<<"$response") || { echo "$response"; exit 1; }
done

# 3. Download each version, or show what went wrong.
if [ "$(jq -r .status <<<"$result")" = failed ]; then
  jq .error <<<"$result"
  exit 1
fi
number=0
for url in $(jq -r '.outputs[].url' <<<"$result"); do
  number=$((number + 1))
  curl --silent --show-error --fail --output "remix-$number.flac" "$url"
  echo "Saved remix-$number.flac"
done