Skip to main content
You can bring your own images into a canvas as file nodes. Uploaded images become first-class assets — they can be referenced by edges, passed to image-tool models, or used as references on video nodes.

​
What’s supported

  • Images — JPEG, PNG, WebP, HEIC.
  • Maximum size — limit depends on plan; current limits are shown in the upload dialog.

​
What’s not supported

  • Video uploads are not supported. Video must be generated on the canvas. (If this changes, the upload dialog will say so.)
  • Audio uploads are not supported.

​
How to upload

  • In the UI — drag an image onto the canvas, or pick Upload from the node toolbar.
  • MCP — call file_upload, curl the file to the returned URL, then call file_upload_complete.
  • CLI — mel upload <path>.

​
Sandboxed-agent network allowlist

If you’re running an MCP-driven agent in a sandboxed environment (Claude Code’s sandboxed shell, for example), the sandbox needs network egress to *.melius.com for uploads to succeed. Add this exact entry to the sandbox’s network allowlist: 
*.melius.com
For Claude Desktop / Claude Code, the toggle lives in Organization Settings → Capabilities → Code execution. See the MCP overview for the full setup.
Last modified on May 16, 2026