sounds

{'type': 'object', 'required': ['role'], 'properties': {'loop': {'type': 'boolean', 'description': 'Require prepared loop metadata; seam evidence is returned separately.'}, 'role': {'type': 'string', 'description': "Role id or alias, e.g. 'click', 'button click', 'purchase-success', 'ka-ching', 'error beep', 'level-up', 'dialogue blip', 'notification'"}, 'style': {'enum': ['balanced', 'crisp', 'soft', 'spacious'], 'type': 'string', 'description': "Optional. balanced (default) = the family's most typical take; crisp = short, bright, dry; soft = darker, gentler; spacious = reverb, longer tail"}, 'format': {'enum': ['wav', 'mp3', 'ogg'], 'type': 'string'}, 'max_duration_ms': {'type': 'number', 'description': 'Hard maximum delivered duration in milliseconds.'}}}

{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': "Sound slug, e.g. 'impact-punch-01'"}}}

{'type': 'object', 'properties': {'set': {'enum': ['ui-crisp', 'ui-soft', 'ui-spacious', 'retro-game', 'chat-app', 'saas-app', 'checkout', 'learning', 'puzzle-game', 'platformer', 'horror-game', 'video-editing', 'smart-device', 'wellness', 'ai-coding-tool', 'acoustic-drum-kit', 'animal-calls', 'dungeon-traps'], 'type': 'string', 'description': 'Set id (default ui-crisp). Includes acoustic-drum-kit, animal-calls and dungeon-traps alongside the UI and scenario sets listed in the enum.'}, 'format': {'enum': ['wav', 'mp3', 'ogg'], 'type': 'string', 'description': 'File format for selection and checks (default WAV). Legacy urls remains MP3; download_urls follows this format.'}}}

{'type': 'object', 'required': ['query'], 'properties': {'loop': {'type': 'boolean', 'description': 'Require (true) or exclude (false) a candidate marked with prepared loop metadata; seam evidence is returned separately.'}, 'limit': {'type': 'number', 'description': 'Max results (default 20, max 50)'}, 'query': {'type': 'string', 'description': "Keywords or a natural-language description, e.g. 'door slam', 'soft UI confirmation chime', 'coin pickup'"}, 'format': {'enum': ['wav', 'mp3', 'ogg'], 'type': 'string', 'description': 'Delivery format (ogg = Ogg Vorbis); loop=true defaults to WAV when omitted.'}, 'category': {'type': 'string', 'description': 'Optional category slug: ui, retro-game, transition, impact, ambience, water, fire-electric, footsteps, door, mechanical, paper-fabric, glass, animal, crowd, cartoon, magic-scifi, horror, feedback, instrument, office, human, vehicle, household'}, 'max_duration_ms': {'type': 'number', 'description': 'Hard maximum delivered duration in milliseconds; format-specific measurement is required.'}}}