Music Generation

Overview

60db’s Music API lets you generate original songs, with vocals or instrumental, in about two minutes. Describe your song in simple English (genre, mood, instruments) or fine-tune every aspect with advanced mode: custom lyrics, vocal gender, duration target, style tags, and seed-based repeatability. Every workspace generates one song at a time — while a generation runs, new requests return a 429 Too Many Requests error. Most songs take 1.5–2.5 minutes to create.

Simple Mode

Describe your song in one line; we’ll write the lyrics for you

Advanced Mode

Full control: your lyrics, vocal gender, instrumentation, BPM, duration

Voice Library

Catalog voices or your own saved voices

Seed Repeatability

Use a seed to regenerate the exact same song

Quickstart

Generate your first song in three steps:

Create a song

Send a prompt and wait for generation to start.

Poll for completion

Check status every 3–5 seconds until the song is ready.

Download the MP3

Fetch the audio file once generation finishes.

cURL
JavaScript
Python

# Step 1: Create a song
curl -X POST https://api.60db.ai/songs \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "upbeat lo-fi hip hop with jazzy chords",
    "mode": "simple"
  }'

# Response: { "success": true, "data": { "batch_id": "xyz", "songs": [ { "id": "song-001", "status": "submitted" } ] } }

# Step 2: Poll for completion (repeat every 3-5 seconds)
curl https://api.60db.ai/songs/song-001 \
  -H "Authorization: Bearer your-api-key"

# Wait for status === "succeeded"

# Step 3: Download the MP3
curl https://api.60db.ai/songs/song-001/download \
  -H "Authorization: Bearer your-api-key" \
  -o my-song.mp3

import { SixtyDBClient } from '60db';

const client = new SixtyDBClient('your-api-key');

// Step 1: Create a song
const result = await client.music.create({
  prompt: 'upbeat lo-fi hip hop with jazzy chords',
  mode: 'simple'
});
const songId = result.data.songs[0].id;

// Step 2: Wait for completion
const song = await client.music.waitForCompletion(songId, {
  intervalMs: 4000,
  timeoutMs: 600000
});

// Step 3: Download
const audioBuffer = await client.music.download(songId);

from sixtydb import SixtyDBClient

client = SixtyDBClient('your-api-key')

# Step 1: Create a song
result = client.music.create(
    prompt='upbeat lo-fi hip hop with jazzy chords',
    mode='simple'
)
song_id = result['data']['songs'][0]['id']

# Step 2: Wait for completion
song = client.music.wait_for_completion(song_id, interval=4, timeout=600)

# Step 3: Download
audio_bytes = client.music.download(song_id)
with open('my-song.mp3', 'wb') as f:
    f.write(audio_bytes)

Simple vs Advanced Mode

Simple Mode

Send a one-line description and we write the lyrics for you.

curl -X POST https://api.60db.ai/songs \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "sad piano ballad about lost love",
    "mode": "simple"
  }'

In simple mode, your prompt becomes the musical style (genre, mood, instruments, BPM). We automatically generate lyrics that fit the vibe.

Advanced Mode

Take full control of the output:

curl -X POST https://api.60db.ai/songs \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Upbeat, indie rock with driving drums",
    "mode": "advanced",
    "lyrics": "[Verse]\nChasing shadows down the street\nLife is fast and oh so sweet",
    "vocal_gender": "Male",
    "voice_id": "vocal-001",
    "target_duration": 180,
    "tags": "electric guitar, pop-rock"
  }'

Advanced mode requires exactly one lyrics source:

lyrics — your own lyrics (with optional [Verse] / [Chorus] tags)
lyrics_prompt — describe what you want: “Write about summer freedom”
lyrics_file — upload a .txt file
instrumental: true — generate without vocals

Lyrics Tips

Section Tags

Organize your lyrics with [Verse] and [Chorus] tags:

[Verse]
Wake up in the morning light
Everything feels right

[Chorus]
This is our time
This is our time to shine

[Verse]
Dancing through the night
Stars are burning bright

[Chorus]
This is our time
This is our time to shine

The model respects these tags and places them appropriately in the music.

Single Source Rule

In advanced mode, provide exactly one of:

User-provided lyrics
A lyrics_prompt (“describe your song idea”)
A lyrics_file (multipart upload)
instrumental: true (no lyrics)

Sending both lyrics and lyrics_prompt returns a 400 Bad Request. Simple mode fills lyrics_prompt automatically from prompt.

Voice Library

Use a catalog voice or save your own custom voice from an audio sample:

JavaScript
Python

// List available voices
const voices = await client.music.listVoices();

console.log('Catalog voices:', voices.data.catalog);
console.log('My voices:', voices.data.mine);

// Use a catalog voice
await client.music.create({
  prompt: 'happy pop song',
  voice_id: 'vocal-001'  // from the catalog
});

// Save your own voice
const voiceFile = document.querySelector('input[type="file"]').files[0];
const newVoice = await client.music.createVoice({
  name: 'My Voice',
  file: voiceFile
});

// Use your saved voice
await client.music.create({
  prompt: 'happy pop song',
  voice_id: newVoice.data.voice_id
});

# List available voices
voices = client.music.list_voices()

print('Catalog voices:', voices['data']['catalog'])
print('My voices:', voices['data']['mine'])

# Use a catalog voice
client.music.create(
    prompt='happy pop song',
    voice_id='vocal-001'  # from the catalog
)

# Save your own voice
with open('my_voice_sample.wav', 'rb') as f:
    new_voice = client.music.create_voice(
        name='My Voice',
        file=f
    )

# Use your saved voice
client.music.create(
    prompt='happy pop song',
    voice_id=new_voice['data']['voice_id']
)

Catalog voices include preview_url (a short sample clip). Your saved voices show null for preview_url.

Limits & Constraints

Constraint	Value
One generation per workspace	Only one song is generated at a time; concurrent requests return 429
Prompt length	1–2000 characters
Lyrics length	≤ 12,000 characters
Song duration hint	10–600 seconds (the model treats it as a hint)
Voice sample length	3–30 seconds for custom voices
Voice sample size	≤ 10 MB
Generation time	~1.5–2.5 minutes typical
Audio URL lifetime	~1 hour (re-fetch the song to get a fresh signed URL)

Pricing

Music generation is free during beta. No credits are charged, and no wallet deductions occur. When we launch paid plans, pricing will be based on song length and quality tier.

Error Handling

Status	Code	Meaning
400	Validation error	Invalid prompt, missing required field, or both `lyrics` and `lyrics_prompt` sent
403	`VOICE_NOT_ACCESSIBLE`	The voice ID isn’t usable by your workspace
404	Not found	Song ID doesn’t exist or isn’t in your workspace
409	`GENERATION_IN_PROGRESS`	A song is already being generated in your workspace; try again in 2 minutes
429	Too many requests	Rate limited (only applies to non-async endpoints)
502	Service unavailable	The music service is temporarily down
503	Service unavailable	The music service is temporarily down

API Reference

Create Song

Generate a new song

List Songs

Get your song library

Get Song

Poll status or fetch details

Update Song

Mark liked or played

Download Song

Get the MP3 file

Delete Song

Move to trash

List Voices

Browse available voices

Create Voice

Save a custom voice

Health Check

Service status

Get Started

SDKs

Core Features

Music Generation

Overview

Simple Mode

Advanced Mode

Voice Library

Seed Repeatability

Quickstart

Simple vs Advanced Mode

Simple Mode

Advanced Mode

Lyrics Tips

Section Tags

Single Source Rule

Voice Library

Limits & Constraints

Pricing

Error Handling

API Reference

Create Song

List Songs

Get Song

Update Song

Download Song

Delete Song

List Voices

Create Voice

Health Check

​Overview

Simple Mode

Advanced Mode

Voice Library

Seed Repeatability

​Quickstart

​Simple vs Advanced Mode

​Simple Mode

​Advanced Mode

​Lyrics Tips

​Section Tags

​Single Source Rule

​Voice Library

​Limits & Constraints

​Pricing

​Error Handling

​API Reference

Create Song

List Songs

Get Song

Update Song

Download Song

Delete Song

List Voices

Create Voice

Health Check

Overview

Quickstart

Simple vs Advanced Mode

Simple Mode

Advanced Mode

Lyrics Tips

Section Tags

Single Source Rule

Voice Library

Limits & Constraints

Pricing

Error Handling

API Reference