Agent Skills
返回列表
Image2URL 图片上传

Image2URL 图片上传

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_77223f8d/image2url。

技能介绍

要解决什么问题

智能体工作流里经常要把本地图片变成可分享的 HTTP 链接:下游工具(例如视频生成、网页嵌入、多模态 API)通常只接受 URL,而不是你磁盘上的路径。Image2URL 把上传托管交给 freeimage.host,技能侧只负责按 API 规范提交文件并解析返回里的 image.url。

技能如何工作

  • 认证:从环境变量 FREEIMAGE_API 读取 API Key,以表单字段 key 随请求提交。
  • 上传:POST https://freeimage.host/api/1/upload,图片通过 source 传入(multipart 文件、URL 或 Base64,以 SKILL 与脚本实现为准)。
  • 格式:支持 JPG、PNG、BMP、GIF、WEBP、TIFF 等;免费档单文件上限 32 MB;成功响应里 image.url 为最常用的直链,另有 url_short、delete_url、宽高与 size 等字段。
  • 调用方式:可直接跑仓库内 scripts/upload.py(标准库 urllib + json),或在 Claw 对话里用自然语言让智能体代传;脚本支持 --format,并可用 [URL_ONLY] 标签方便程序截取 URL。

边界与注意点

链接在文档中描述为永久有效,仍依赖第三方图床可用性与账号配额;错误码如 1(无效 Key)、4/6(非有效图片或格式)、7(过大)、8(日限额)需在上层重试或换源时对照处理。服务条款禁止色情/非法内容,生产用途请自行评估合规与备份策略。

使用场景

  • 在 Claw 对话里上传本地截图,拿到 `image.url` 后交给 agnes-video-gen 等技能做视频生成
  • 跑 `scripts/upload.py` 把设计稿或日志截图传到 freeimage.host,输出带 `[URL_ONLY]` 的直链给下游脚本解析
  • 智能体流程里只有本地文件路径,需先上传再向只接受 HTTP 图片地址的多模态 API 发起请求
  • 用 multipart 的 `source` 字段批量把 PNG/WebP 素材变成永久公开链接,写入文档或工单描述

适合人员

  • 在 Claw 里编排多技能、需要把本地图转成 URL 再交给视频/网页类下游的自动化工程师
  • 写 Python 小工具且不想引第三方库、只用标准库上传并读取 `FREEIMAGE_API` 的后端开发者
  • 运营或技术写作者要把本地配图变成可嵌入 Markdown/协作文档的稳定外链
  • 对接 freeimage.host API、需对照错误码 1/4/7/8 做重试与限额处理的集成维护者