upload_file
ActiveTool of Hermoso
Persist an ARBITRARY user file (image or video, up to 150MB) into Hermoso and get back a durable public URL you can pass to post_to_meta / upload_meta_asset / create_meta_ad — including files that have NOTHING to do with a Hermoso render (e.g. media on the user's desktop). Provide exactly ONE source: `path` (a local file — works ONLY when Hermoso runs locally over stdio/CLI; the hosted connector can't see the user's machine), or `dataUri` (a base64 data: URI — keep under ~15MB on the hosted connector). If the file is ALREADY at a public https URL you do NOT need this — pass that URL straight to post_to_meta/upload_meta_asset and the server re-hosts it safely. Returns {url, kind, bytes}.
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"name": {
"type": "string",
"description": "original file name — helps pick the right extension"
},
"path": {
"type": "string",
"description": "local filesystem path (stdio/CLI only — refused on the hosted connector)"
},
"dataUri": {
"type": "string",
"description": "base64 data: URI of the file bytes (data:<mime>;base64,<…>)"
}
}
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
Hermoso
https://github.com/hermoso-ai/hermoso
1/7 registries