> ## Documentation Index
> Fetch the complete documentation index at: https://rpa.bazhuayu.com/helpcenter/llms.txt
> Use this file to discover all available pages before exploring further.
# 上传图片
## 一、指令概述
该 RPA 指令用于将本地图片上传至飞书，通过飞书访问凭证完成认证，上传成功后会生成图片在飞书的唯一标识 ImageKey 及运行结果，便于后续流程（如 “发送消息” 指令中引用图片）使用。
飞书官方开发文档参考：[https://open.feishu.cn/document/server-docs/im-v1/image/create](https://open.feishu.cn/document/server-docs/im-v1/image/create)
## 二、调用参数配置示意
参数名称示例 / 默认值说明指令上传图片固定选择 “上传图片”，表示执行飞书图片上传操作。飞书访问凭证飞书访问凭证配置飞书开放平台的访问凭证（需具备图片上传权限，可通过 “获取飞书访问凭证” 指令生成），支持变量（界面显示 “\{x}” 标识）。图片路径（如 “C:\Images\report.png”）输入要上传的本地图片文件路径；可点击「选择文件」按钮选取本地图片，支持变量。生成的变量 - 运行结果变量（自定义变量名）存储图片上传的执行结果（如成功状态、错误信息等，对应飞书 API 返回的完整响应），需配置为自定义变量，后续流程可调用，支持变量。生成的变量 - ImageKeyImageKey（自定义变量名）存储上传后图片在飞书的唯一标识（对应飞书 API 返回的image\_key字段），用于后续发送图片消息等场景引用该图片，需配置为自定义变量，支持变量。
## 三、使用示例（上传报表截图场景）
### 场景：将本地路径为 “C:\Reports\2025Q3\_sales.png” 的报表截图上传至飞书，获取 ImageKey 用于后续发送。
#### 参数配置：
• 指令：上传图片
• 飞书访问凭证：feishuAuthToken（通过 “获取飞书访问凭证” 指令生成的变量）
• 图片路径：C:\Reports\2025Q3\_sales.png（或通过「选择文件」选取）
• 运行结果：uploadResult（自定义变量，存储上传结果的完整 API 响应）
• ImageKey：salesReportImgKey（自定义变量，存储图片唯一标识image\_key）
#### 执行流程：
调用该 RPA 指令后，RPA 会通过 feishuAuthToken 完成飞书 API 认证，读取本地路径的报表截图并上传至飞书；上传完成后，将飞书 API 返回的完整响应存入 uploadResult，并提取响应中的image\_key赋值给 salesReportImgKey。后续可在 “发送消息” 指令中，引用 salesReportImgKey 作为 “文件 / 图片 Key” 发送该图片。
## 四、返回结果说明
### 1. 飞书 API 标准响应示例（成功场景）：
指令执行后，“运行结果” 变量（如uploadResult）会存储飞书 API 返回的完整 JSON 响应，格式如下：
\{ "code": 0, "data": \{ "image\_key": "img\_v2\_xxx" // 图片在飞书的唯一标识，与RPA中的ImageKey变量对应 }, "msg": "success"}
### 2. 响应字段含义：
• code：状态码，0 表示上传成功，非 0 为失败（具体错误码含义可参考飞书官方开发文档）。
• msg：提示信息，success 表示上传成功，失败时会返回具体错误描述（如 “权限不足”“文件格式错误”）。
• data：核心返回数据，包含 image\_key 字段 —— 即图片在飞书的唯一标识，RPA 会自动提取该字段值存入 “生成的变量 - ImageKey”（如salesReportImgKey）。
### 3. ImageKey 结果：
“生成的变量 - ImageKey”（如salesReportImgKey）会被直接赋值为响应中的image\_key字符串（如img\_v2\_xxx），后续可通过该标识在飞书内定位并使用这张图片。
## 五、注意事项
1. 访问凭证有效性：“飞书访问凭证” 需具备图片上传权限且未过期（建议通过 “获取飞书访问凭证” 指令动态生成有效凭证），否则会因权限不足或凭证失效导致上传失败（对应 API 响应code≠0，msg会提示具体原因）。
2. 图片路径合法性：“图片路径” 需指向本地真实存在的图片文件（格式支持 PNG、JPG、JPEG 等飞书 API 兼容格式，具体可参考官方文档），否则会因 “文件不存在”“格式不支持” 报错。
3. 变量与 API 响应关联：“生成的变量 - ImageKey” 是从 API 响应的data.image\_key字段提取的，需确保变量配置正确，避免因字段匹配错误导致无法获取标识。
4. 后续场景联动：上传成功后，ImageKey（即image\_key）可直接用于 “发送消息” 指令的 “文件 / 图片 Key” 参数，实现 “上传图片 → 发送图片消息” 的自动化闭环，无需额外转换格式。
## 六、延伸应用
可结合 RPA 的 “发送消息” 指令与 “定时触发” 指令，实现定时上传 + 发送图片的自动化流程：例如每日凌晨自动读取本地生成的业务报表截图（如 “C:\DailyReports\20250930\_sales.png”），调用本指令上传至飞书并获取ImageKey，再通过 “发送消息” 指令将图片发送至指定飞书群组（如 “销售数据同步群”），同时附带文本说明（如 “2025 年 9 月 30 日销售日报”），替代人工手动上传和发送操作，提升办公效率。
使用指令过程中遇到问题？前往 [八爪鱼RPA 开发者社区问答板块](https://rpa.bazhuayu.com/community/questions) 提问，获取官方与社区帮助。