API Reference

# Generate a song
RESPONSE=$(curl -s -X POST https://generatesongs.ai/api/v1/songs/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"style": "chill lo-fi hip hop"}')

SONG_ID=$(echo $RESPONSE | jq -r '.songId')

# Poll until complete
while true; do
  STATUS=$(curl -s https://generatesongs.ai/api/v1/songs/$SONG_ID \
    -H "Authorization: Bearer $API_KEY" | jq -r '.status')
  [ "$STATUS" = "completed" ] && break
  sleep 10
done

# Download MP3
curl -OJ 'https://generatesongs.ai/api/v1/songs/$SONG_ID?download' \
  -H "Authorization: Bearer $API_KEY"

# Download FLAC (lossless)
curl -OJ 'https://generatesongs.ai/api/v1/songs/$SONG_ID?download&format=flac' \
  -H "Authorization: Bearer $API_KEY"

const API_KEY = process.env.GENERATESONGS_API_KEY;
const BASE = "https://generatesongs.ai/api/v1";

async function generateSong(style) {
  const res = await fetch(`${BASE}/songs/generate`, {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ style }),
  });

  const { songId } = await res.json();

  // Poll for completion
  while (true) {
    const song = await fetch(
      `${BASE}/songs/${songId}`,
      { headers: { "Authorization": `Bearer ${API_KEY}` } }
    ).then(r => r.json());

    if (song.status === "completed") return song;
    if (song.status === "failed") throw new Error("Generation failed");
    await new Promise(r => setTimeout(r, 10000));
  }
}

const song = await generateSong("dreamy synthwave");
console.log(song.downloadUrl);

import requests, time, os

API_KEY = os.environ["GENERATESONGS_API_KEY"]
BASE = "https://generatesongs.ai/api/v1"
headers = {"Authorization": f"Bearer {API_KEY}"}

# Generate
res = requests.post(
    f"{BASE}/songs/generate",
    headers=headers,
    json={"style": "ambient electronic"}
)
song_id = res.json()["songId"]

# Poll
while True:
    song = requests.get(
        f"{BASE}/songs/{'{song_id}'}",
        headers=headers
    ).json()
    if song["status"] == "completed":
        break
    time.sleep(10)

# Download
audio = requests.get(song["downloadUrl"], headers=headers)
with open("song.mp3", "wb") as f:
    f.write(audio.content)