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

agent tool trace
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 note

user

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

agent tool trace
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 kbps

user

What qualities are available for this Instagram reel? Do not download yet.

Check formats before spending a credit

agent tool trace
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

agent tool trace
cancel_download({ "job_id": "job_..." })
download_video({ "url": "...", "format": "mp4", "quality": "720p" })
# the canceled job refunds its credit

When 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_CONTENT

The post is private. Ask for a public link or stop.

LOGIN_REQUIRED

The platform wants a session. The server will not accept cookies.

DRM_PROTECTED

Refuse. Do not suggest a DRM removal tool.

DURATION_LIMIT_EXCEEDED

The 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.