Skip to content

Latest commit

 

History

History
214 lines (168 loc) · 4.01 KB

BATCH.md

File metadata and controls

214 lines (168 loc) · 4.01 KB

Batch Generation Guide

Generate multiple songs at once from a YAML file.

Basic Usage

# From local file
suno batch songs.yaml -o ./output

# From URL
suno batch https://example.com/album.yaml -o ./output

YAML Format

songs:
  - title: "Song 1"
    prompt: path/to/lyrics1.txt
    style: "pop, upbeat"

  - title: "Song 2"
    prompt: |
      Verse 1:
      Inline prompt works too
      No separate file needed
    style: path/to/style.txt

Required Fields

Each song must have:

  • title - Song title
  • prompt - File path or inline text
  • style - File path or inline text

Optional Fields

- title: "My Song"
  prompt: lyrics.txt
  style: "pop"

  # Optional fields
  output: ./custom-dir     # Custom output directory
  model: V5                # AI model
  gender: female           # Vocal gender
  instrumental: true       # Instrumental only

  # ID3 Tags
  artist: "My Band"
  album: "First Album"
  track: 3
  cover: cover.jpg         # Custom cover
  generate_cover: true     # Generate AI cover

Modes

Sequential (Default)

Generates songs one after another:

suno batch songs.yaml -o ./album

Parallel

Starts all generations at once:

suno batch songs.yaml -o ./album --parallel

Delayed Sequential

Wait N seconds between each song:

suno batch songs.yaml -o ./album --delay 10

Use Cases

1. Complete Album

# album.yaml
songs:
  - title: "Opening Track"
    prompt: track1.txt
    style: "pop, energetic"
    track: 1
    album: "My Album"
    artist: "My Band"
    cover: album-cover.jpg

  - title: "Second Song"
    prompt: track2.txt
    style: "pop, mid-tempo"
    track: 2
    album: "My Album"
    artist: "My Band"
    cover: album-cover.jpg

  - title: "Ballad"
    prompt: track3.txt
    style: "ballad, emotional"
    track: 3
    album: "My Album"
    artist: "My Band"
    gender: female
    cover: album-cover.jpg
suno batch album.yaml -o ./my-album

2. Style Variations

Generate the same song in different styles:

# variations.yaml
songs:
  - title: "Dreams - Pop Version"
    prompt: dreams.txt
    style: "pop, upbeat, 120 BPM"

  - title: "Dreams - Rock Version"
    prompt: dreams.txt
    style: "rock, energetic, 140 BPM"

  - title: "Dreams - Acoustic"
    prompt: dreams.txt
    style: "acoustic, intimate, folk"
    gender: female

  - title: "Dreams - Electronic"
    prompt: dreams.txt
    style: "electronic, EDM, 128 BPM"

  - title: "Dreams - Jazz"
    prompt: dreams.txt
    style: "jazz, smooth, sophisticated"

  - title: "Dreams - Instrumental"
    prompt: dreams.txt
    style: "cinematic, orchestral"
    instrumental: true
suno batch variations.yaml -o ./variations --parallel

3. Simple Batch

# songs.yaml
songs:
  - title: "First Song"
    prompt: "Verse 1: Walking down the street..."
    style: "pop, upbeat"

  - title: "Second Song"
    prompt: "Verse 1: Stars are shining bright..."
    style: "dance pop, energetic"
    gender: female
suno batch songs.yaml -o ./songs

Output Structure

output/
├── song_01/
│   ├── track_1.mp3
│   ├── track_2.mp3
│   └── metadata.json
├── song_02/
│   ├── track_1.mp3
│   ├── track_2.mp3
│   └── metadata.json
└── song_03/
    ├── track_1.mp3
    ├── track_2.mp3
    └── metadata.json

Or with custom output directories:

output/
├── track1/
├── track2/
└── track3/

Examples

See examples/ directory:

  • batch-simple.yaml - Basic batch
  • batch-album.yaml - Full album with 5 tracks
  • batch-variations.yaml - Same song, 6 different styles

Tips

  1. Parallel vs Sequential: Use --parallel for faster completion, sequential for API rate limiting
  2. Album Production: Use same album, artist, and cover for all tracks
  3. Variations: Use same prompt with different style for comparisons
  4. Output: Specify custom output per song for better organization