Udio

Setup

On first use, read setup.md for integration guidelines.

When to Use

User wants to generate music with Udio. Agent can use API wrappers for programmatic generation, browser automation for direct platform interaction, or guide prompt engineering.

Architecture

Memory at ~/udio/. See memory-template.md for structure.

~/udio/
├── [memory.md]       # Created on first use: preferences, auth token location
├── [projects/]       # Per-project song tracking
└── [songs/]          # Downloaded audio files

Quick Reference

Core Rules

1. Choose the Right Approach

2. API Requires Auth Token

Udio has no official public API. Community wrappers use the internal API:

• Token: sb-api-auth-token cookie from udio.com
• Token expires: refresh if 401 errors occur
• See api.md for setup instructions

3. Structure Prompts in Layers

[genre] [subgenre] [mood] [instruments] [voice] [era/influence]

Example: "indie folk melancholic acoustic guitar female vocals 90s"

4. Extend Songs Strategically

Udio generates ~30 second clips. Build full songs:

1. Create initial clip with strong hook
2. Extend 2-3 times with consistent style
3. Add outro with ending indicators
4. Target 2-4 minutes total

5. Save Successful Seeds

Same prompt + different seed = different result. When close to desired output:

• Note the seed number
• Try adjacent seeds (seed +/- 1)
• Document working combinations

API Integration

Python Wrapper (Recommended)

pip install udio_wrapper

from udio_wrapper import UdioWrapper

# Initialize with auth token
udio = UdioWrapper("your-sb-api-auth-token")

# Create a song
song = udio.create_song(
    prompt="electronic ambient downtempo dreamy synth pads",
    seed=-1,  # -1 for random
    custom_lyrics="Optional lyrics here"
)

# Extend the song
extended = udio.extend(
    prompt="add drums and bass, building energy",
    audio_conditioning_path=song['song_path'],
    audio_conditioning_song_id=song['id']
)

# Add outro
outro = udio.add_outro(
    prompt="gentle fade out, conclusion",
    audio_conditioning_path=extended['song_path'],
    audio_conditioning_song_id=extended['id']
)

TypeScript/Node Wrapper

npm install udio-wrapper

import { createUdioWrapper } from 'udio-wrapper';

const client = await createUdioWrapper('your-auth-token');