SuperAPI AI 工具集

uploading-with-uplink

编程与开发

查看项目

更新于 10-16 03:17

技能介绍

用途:通过自托管 up!link REST API 上传和分享文件,适用于上传本地文件、抓取在线 URL,或创建临时、永久、短链接。

主要能力:上传本地文件(默认生成临时链接);用 permanent=true 生成永久链接;用 short=true 生成七天短链接,并可用 shortName=<name> 自定义路径;对已在线文件调用 POST ${base%/}/api/ingest-url(JSON 含 url、filename、permanent);客户端直传时调用 POST /api/upload-url,再向返回的 uploadUrl 用 PUT 上传字节(不带 API 密钥)。

使用方式:仅用 curl,切勿打印或提交 UPLINK_API_KEY;缺失时请用户配置,不要猜测。密钥形如 uplink_<host><secret>,可推导基础地址:rest="${UPLINK_API_KEY#uplink}";base="${UPLINK_BASE_URL:-https://${rest%*}}"。若密钥无 uplink 前缀,则必须提供 UPLINK_BASE_URL,未设置时向用户索取。上传本地文件示例:curl -sS --fail-with-body "${base%/}/api/upload" -H "Authorization: Bearer $UPLINK_API_KEY" -F "file=@<path>" -F "permanent=false"。仅在要求时使用 permanent=true。返回时只给出相关的 temporaryUrl、permanentUrl 或 shortUrl,而非完整响应。

限制与错误处理:401 视为配置错误,403 视为签名 URL 过期或无效,409 视为自定义路径重复,413 时应改用 multipart 而非 JSON。其余细节暂未提供。