Upload a design image
upload_imageUpload one design image and get back an image id to use in create_shop_product. If the image is already in the account, or only on the merchant's computer, use list_my_images instead. Otherwise prefer url - the server downloads the image itself, which is fast and costs you nothing. Only fall back to imageBase64 (plus filename) for very small images, because that requires you to write out the whole encoded file and will stall on anything sizeable. Upload the artwork at its natural size - placement and scaling are decided later, per print area, in create_shop_product.
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": "upload_image"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | STRONGLY PREFERRED. Public http(s) URL of the image - the server downloads it directly, so nothing large passes through this conversation. Use this whenever the image is reachable by URL. Provide either url or imageBase64, never both. | |
| filename | No | Filename including the real extension, e.g. logo.png or logo.svg. Required when using imageBase64, because the extension determines how the file is processed. | |
| imageBase64 | No | LAST RESORT, and only for images under roughly 100KB. You must write out the entire base64 string yourself, so a 1MB image costs hundreds of thousands of output tokens and will usually stall or be truncated before it completes. If the image is only on the merchant's computer, ask them to upload it under My Designs in the seller app and find it with list_my_images instead. Provide either url or imageBase64, never both. |