get_role_sound
Aucun détail d’effet fourniAfficher les détails fournis par le serveur
Description du serveur (copiée ; langue non vérifiée)
Choose this when the task calls for a sound for a named event or interaction — a button click, purchase success, error beep, level-up, dialogue blip, rain loop. Pass the role as plain words: role ids (click, success, purchase-success, dialogue-blip, rain-loop…) and common aliases (button click, ka-ching, jump scare, text blip…) are all accepted. Returns a qualified candidate for that role when one satisfies the requested constraints, with MP3/WAV URLs, 2-3 alternates and the family page for browsing more. Five core game roles include content_check (verified/unverified/rejected), scoped to scene, role, format and exact file SHA256; unverified previews are not certified suitable. Download selected files locally and retain originals. Task-permitted processing requires a recipe, output SHA256, renewed file checks and a listening check; changed bytes do not inherit content review. Other task-permitted sources or local synthesis may be mixed in. Optional style: crisp (short, bright, dry), soft (darker, gentler), spacious (reverb, longer tail), balanced (default: most typical). Loop roles require prepared loop metadata; WAV seam evidence and MP3 padding are reported separately and may remain unknown. For multiple events consider get_sound_set; use search_sounds for a description or a gap. These are task branches, not a fixed sequence. Unknown roles return not_found with the full role list; GET https://sfxmint.com/api/v1/roles lists roles with aliases.
Schéma d’entrée (aperçu fourni par le serveur — ne pas copier)
{
"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', 'rain-loop'"
},
"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."
}
}
}