Upload a local file → durable public URL
upload_fileUpload an image or video (up to 150MB) to Hermoso and receive a durable public URL. Accepts a local file path or base64 data URI.
Instructions
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}.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | original file name — helps pick the right extension | |
| path | No | local filesystem path (stdio/CLI only — refused on the hosted connector) | |
| dataUri | No | base64 data: URI of the file bytes (data:<mime>;base64,<…>) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | ||
| kind | No | ||
| bytes | No |