Examples
What to ask the agent.
These prompts assume the skill and MCP server are installed. Each example shows the tool sequence a well-behaved agent should follow.
Prompts and traces
Resolve first, create one job, poll, then hand over the signed URL.
user
Download this TikTok without the watermark and give me the file: https://www.tiktok.com/@user/video/123
Save a public TikTok as MP4
resolve_video({ "url": "https://www.tiktok.com/@user/video/123" })
download_video({ "url": "...", "format": "mp4", "quality": "1080p" })
get_download({ "job_id": "job_..." }) # poll every 2s
# reply with the signed URL and the 15 minute expiry noteuser
Turn this into an MP3 I can listen to offline: https://www.youtube.com/watch?v=aqz-KE-bpKQ
Extract the audio from a YouTube video
resolve_video({ "url": "https://www.youtube.com/watch?v=aqz-KE-bpKQ" })
extract_audio({ "url": "https://www.youtube.com/watch?v=aqz-KE-bpKQ" })
get_download({ "job_id": "job_..." })
# the file is audio/mpeg, 192 kbpsuser
What qualities are available for this Instagram reel? Do not download yet.
Check formats before spending a credit
list_formats({ "url": "https://www.instagram.com/reel/..." })
# stop. No download job, no credit spent.user
That download is taking too long. Cancel it and try the 720p version.
Cancel a long job
cancel_download({ "job_id": "job_..." })
download_video({ "url": "...", "format": "mp4", "quality": "720p" })
# the canceled job refunds its creditWhen the answer is no
A good agent reports the refusal instead of trying another route. The server returns the same codes to the skill and to the API.
PRIVATE_CONTENTThe post is private. Ask for a public link or stop.
LOGIN_REQUIREDThe platform wants a session. The server will not accept cookies.
DRM_PROTECTEDRefuse. Do not suggest a DRM removal tool.
DURATION_LIMIT_EXCEEDEDThe video is over 30 minutes. Offer the audio or a shorter clip.
Want to see the raw response for any of these? The API reference has every field.