sonilo-workflows10.9 KB
View saved version →
---
name: sonilo-workflows
description: Create licensed music, sound effects, mixed videos, translated subtitles, and dubbed videos with a Sonilo Platform account. Preserve speech, request variants or stems, keep names and terms intact with a glossary, and retrieve existing tasks. Validate public HTTPS media inputs before any tool call, and send a local file only through Sonilo's own upload tool; never direct users to pricing, checkout, subscriptions, or credit recharge.
---
# Sonilo Workflows
Use the connected hosted MCP schemas and returned data as the source of truth.
This plugin does not install the local `sonilo-mcp` Python server. Do not assume
a tool or parameter exists because it appears in that repository.
For the bundled connection, use the `sonilo_platform` MCP server. If a legacy
local `sonilo` server is also available, do not use it for this workflow or
fall back to it after a hosted authentication error. Reconnect the hosted
Sonilo Platform connection instead. Registered directory connections may
use a different namespace; identify them by their hosted schemas, including
`get_generation_task`, rather than assuming every Sonilo tool is equivalent.
## Account identity and availability
- A Sonilo Platform account is required. OAuth connects the user to
`platform.sonilo.com`. Accounts created only on `sonilo.com` belong to a
separate creator account system.
- Never direct users to `sonilo.com` for plugin authentication. Never ask for
passwords, API keys, one-time codes, or MFA codes.
- After validating any media inputs, call `get_account_services` before a new
generation to check service availability and trial allowance. Check both
the connected tools and `available_services`; describe an unavailable feature
honestly instead of silently substituting a different paid operation.
`analyze_video` uses the service key `video_analysis`, and
`generate_video_subtitles` uses the service key `proofread`; other
generation tools in the routing table use their tool name as the service key.
- For account questions or a credit rejection, read
[account and links](references/account-and-links.md). `get_usage` reports
historical spending, not the remaining balance.
## Validate remote media inputs
Before calling any Sonilo MCP tool for a media-input request, validate every
user-supplied video, audio, and subtitle URL.
- Require a publicly reachable `https://` URL. Reject `http://`, `file://`,
localhost, loopback, link-local, private-network, and other non-public URLs.
- For an invalid URL, explain the public-HTTPS requirement and ask for a valid
replacement. Do not call even a read-only Sonilo tool, browse or fetch the
unsafe URL, attempt to transform it, or start generation.
- Do not claim that a URL is public merely because it uses HTTPS. The hosted
service remains responsible for DNS resolution, redirect validation, and
SSRF protections. A filename or local attachment is not a public URL; do not
upload a user's file to a third-party host to obtain one. The only supported
upload path is the one below.
## Use a local file
When the user asks to process a file on their own machine, use the hosted
`create_upload_url` tool if it is among the connected tools and this
environment can send the file's bytes in an HTTP PUT.
1. Proceed only when the request clearly covers that file, and say that the
file will be uploaded to temporary storage on the user's Sonilo Platform
account. Do not upload files the user did not name.
2. Call `create_upload_url` with the file's name and its exact size in bytes.
It is free and creates no task. It accepts video, audio, `.srt`, and `.vtt`
files up to `max_upload_size_mb` from `get_account_services`.
3. Send the raw bytes to the returned `upload_url` with one HTTP PUT, for
example `curl -T <path> "<upload_url>"`, adding no authorization header.
A 403 means the size did not match or the URL expired: request a new URL
instead of retrying the old
Preview of the first 4,000 characters. Read full instructions →
Referenced files: 4 — file references are metadata, not package contents.