Create Upload Tool
create_uploadPut the user's own photos or images (product shots, headshots, screenshots) into renders. You can see images attached in chat but can't pass their bytes to a tool, so this returns one Upload per file name, each with its permanent url to use in right away, plus two ways to send the files. 1) If you can run code and have the files, send each from your sandbox: curl -T sofa.jpg "". 2) If that fails (no sandbox, no network access to this server), give the user the one upload_page_url, where they drop all the photos at once, and wait for them to say it is done. Name each file in filenames as the user knows it (sofa.jpg, lamp.png): the page matches dropped files by name, then fills the rest in order. Up to 10 per call; each link takes one file and expires in an hour. JPEG, PNG or WebP up to 15 MB each; files are re-encoded without metadata and scaled to at most 4000 px. A render that uses an Upload still waiting for its file fails with a reminder, without counting.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "create_upload"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filenames | No | One name per photo, for example ["sofa.jpg", "lamp.png"], up to 10. Shown to the user on the upload page and in list_uploads. Omit for a single unnamed Upload. |