TOOL API
slide_ add_ image
在指定幻灯片插入一张图片。【图片来源选择优先级(按推荐顺序)】方式一(⭐首选):本地脚本(insert_image.py)通过 HTTP 直接调用 MCP endpoint 插入图片,无需把图片 base64 通过 MCP 通道透传,避免大图触发上下文/传输限制,速度也更快。方式二(备选):传 image_id —— 当无法在本地执行脚本,但可以先通过 upload_image MCP 工具或腾讯文档开放平台 OpenAPI 把图片上传后获取 image_id 时使用。方式三(兜底):传 content(图片 base64 字符串,不含 data URI 前缀)—— 仅适合图片体积较小的场景;若 base64 超出 MCP 单次传输限制会失败,此时请回退到方式一脚本调用。【限制】单张图片大小不超过 10MB;支持 PNG / JPG / JPEG / GIF / BMP / WEBP / SVG 格式;【⭐图片等比缩放(强制,禁止违反)】入参 w / h 必须严格保持图片原始宽高比(uniform scale only):即 w / h == 原图 width / height;绝对禁止只调宽不调高、或只调高不调宽——任何横向单独缩放/纵向单独缩放都会导致图片变形,属于硬性禁令;推荐做法:先取得图片原始尺寸,按目标占位框 (W,H) 计算 s = min(W/origW, H/origH),最终传入 w = origW * s,h = origH * s;简化:若仅指定 w,则按 h = w * origH / origW 推算 h;仅指定 h 同理;w / h 同时 <= 0 时使用图片自身原始尺寸;如果图片在目标占位框内放不下(按等比缩放后会留大块空白或溢出画布),禁止通过非等比拉伸强行填满——应重新设计该页面布局;画布默认 16:9 = 960 x 540 pt;调用 slide_get_page_info 获取实际尺寸后再决定占位框范围。(SLIDE) if both tencent-docs (personal) and tencent-docs-oa (enterprise) are connected, use AskUserQuestion to let the user pick the target account before invoking this tool.
Call information
- Tool slug
- tencent-docs.slide_add_image
- Provider
- Tencent Docs
- Average response
- 0 ms
- Calls in 7 days
- 0
Input parameters
content图片的 base64 编码内容(不含 data URI 前缀,兜底方式三,仅适合小图);与 image_id 二选一。大图请优先使用本工具描述中【方式一】的本地脚本(slide_add_image 工具名),或【方式二】通过 upload_image / 开放平台 OpenAPI 上传后传 image_id
file_id文档ID,与 file_url 二选一
file_url在线幻灯片URL,与 file_id 二选一
h图片高度(磅 pt,1pt = 12700 EMU),<=0 时使用图片自身原始高度
image_id已上传图片的加密 ID(有效期一天,方式二备选),与 content 二选一。可通过 tencent-docs MCP 的 upload_image 工具上传后获取,或通过腾讯文档开放平台 OpenAPI 获取。详细获取流程参见工具描述。
page_index目标幻灯片页索引,从 0 开始
w图片宽度(磅 pt,1pt = 12700 EMU),<=0 时使用图片自身原始宽度
x图片左上角横坐标(磅 pt,1pt = 12700 EMU)
y图片左上角纵坐标(磅 pt,1pt = 12700 EMU)