music-generation

name: Music Generation description: Generates original background music using Google's Music Generation API. Creates soundtracks matched to scene mood and timing. triggers: - Video has been generated and needs soundtrack - User wants background music for their creation keywords: - music - soundtrack - BGM - audio

Music Generation Skill

Creates original background music that matches the mood and pacing of video scenes.

When to Use

• After video generation → Add matching soundtrack
• User wants custom music for their scene
• Need to set emotional tone with audio

Inputs

Mood Options

Style Options

Outputs

Implementation Contract

class MusicGenerator:
    async def execute(
        self,
        scene_description: str,
        mood: str,
        duration: int = 30,
        style: str = "anime_orchestral"
    ) -> tuple[Path, dict]:
        """
        Generate background music for a scene.

        Raises:
            ValueError: If mood or style is invalid
            APIError: If Music API call fails
        """
        ...

Example Usage

from skills.generate_music import MusicGenerator

skill = MusicGenerator()

# Basic usage
audio_path, metadata = await skill.execute(
    scene_description="Two characters explore a neon-lit city",
    mood="adventurous"
)

# Full control
audio_path, metadata = await skill.execute(
    scene_description="Peaceful morning in a meadow",
    mood="peaceful",
    duration=45,
    style="anime_orchestral"
)

Integration with Video

# Generate music to match video
video_path, video_meta = await video_skill.execute(...)

music_path, music_meta = await music_skill.execute(
    scene_description=scene_concept["scene_description"],
    mood=scene_concept["mood_for_music"],
    duration=video_meta["duration"]
)

# Compose together
final = await compose_skill.execute(
    video=video_path,
    audio=music_path
)

Dependencies

• Google Music Generation API
• Scene concept (for mood extraction)

API Reference

See: https://ai.google.dev/gemini-api/docs/music-generation

Error Handling