用途:将图片上传到飞书或 Lark,获得 image_key,以便在飞书消息中发送或嵌入图片。
主要能力:支持从本地文件、HTTP URL、Base64 数据三种来源上传图片;通过 --type/--image-type 指定用途,可选 message(消息图片)或 avatar(头像)。返回 JSON 中包含 image_key,可用于发送图片消息或在富文本中嵌入图片。
使用方式:本地文件上传使用 python3 ./scripts/upload_image.py /path/to/image.jpg;HTTP 上传使用 python3 ./scripts/upload_image.py --type message --image-type message https://example.com/image.jpg;Base64 上传使用 python3 ./scripts/upload_image.py --base64 "iVBORw0KGgoAAAANS..."。上传后需配合飞书访问令牌(tenant_access_token 或 app_access_token)与接收者 ID(open_id、user_id、chat_id 或 email),调用消息发送 API 使用 image_key。发送图片消息需要 im:message:send_as_bot 权限。
限制:最大文件 10MB;支持 JPEG、PNG、WEBP、GIF、TIFF、BMP、ICO;GIF 分辨率不超过 2000×2000,其他格式不超过 12000×12000。image_key 有效期通常为 7 天。建议先上传图片,再发送消息,两步操作分离。其他未在资料中说明的功能、收费与平台支持情况暂未提供。