Find a sound
find_soundLocate an edit sound by name, moment, meaning, or link and return a durable MP3 with start and end points, plus alternate candidates.
Instructions
A sound for an edit by name ('the FAAAA sound'), by the moment ('bad news reaction') or by link (TikTok sound, meme-sound page, post, audio file): a durable mp3 and where it starts and lands. Named/described sounds come from what TikTok uses now; pick takes another candidate. A sound that does not exist yet is generate_sfx.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "find_sound"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | link to a TikTok sound, a post, a meme-sound page or an audio file | |
| pick | No | candidate number from the previous list to take instead of the first | |
| query | No | sound by name, moment or meaning, e.g. 'bad news reaction' | |
| get_cost | No | true: return the price only; nothing runs or bills | |
| idempotency_key | No | chosen once, resent unchanged on retries: the same key never buys twice | |
| expected_credits | No | the get_cost price; refused unbilled if the live price differs |