用途:把本地文件上传到 S3 云存储并得到可公开访问的 URL,也支持托管静态站点(HTML/CSS/JS)并绑定自定义域名,配合 agentcash 钱包以 x402 微支付完成付款,无需 API 密钥,支付即认证。
主要能力:文件上传(单文件购买一个上传位,返回 publicUrl);已有上传的列表与详情查询;静态站点部署、更新、续期;自定义域名附加、解绑与 DNS 预览、域名状态查询;域名自动 HTTPS。文件类型不限,contentType 仅为浏览器参考。
使用方式:先检查钱包余额 npx agentcash@latest balance,余额不足时用 npx agentcash@latest accounts 获取充值链接与地址;用 ls -la 或 wc -c 确认文件大小以选择档位;购买上传位,例如 npx agentcash@latest fetch https://stableupload.dev/api/upload -m POST -b '{"filename": "report.pdf", "contentType": "application/pdf", "tier": "10mb"}',参数为 filename、contentType、tier,可选 policyTtlSeconds(60–86400);随后用 curl 以 PUT 上传,命令为 curl -s -X PUT "<uploadUrl>" -H "Content-Type: <mime>" --data-binary @/absolute/path/to/file,须使用 --data-binary 和绝对路径;上传后把返回的 publicUrl 提供给用户或用于邮件等场景。若 uploadMethod 为 post,则按 postUrl 与 postFields 提交 multipart 表单。站点流程为购买站点位、上传 zip、调用 /api/site/activate 激活,更新时 PUT /api/site 后重新上传并激活。
档位与费用(资料提供):10mb 10MB/6个月/0.02 美元;100mb 100MB/6个月/0.20 美元;1gb 1GB/6个月/2.00 美元;short-10mb 10MB/7天/0.005 美元;short-100mb 100MB/7天/0.02 美元;short-1gb 1GB/7天/0.10 美元;short-5gb 5GB/7天/0.50 美元。默认档位 6 个月,short-* 为 7 天,short-5gb 仅用于文件上传不支持站点。站点续期费为档位价乘数量。
限制:上传 URL 会过期,需及时上传或在购买时设置 policyTtlSeconds;公开 URL 仅保留对应档位期限;每个站点最多 500 个文件,档位限制按未压缩大小计算,站点不支持 short-5gb;自定义域名依赖 Cloudflare 提供自动 HTTPS。错误处理方面,上传 URL 过期需重新购买且前次付款不退;余额不足用 accounts 查看充值方式;文件过大需选更高档位;curl 失败需核对路径与 URL 引号。安装与钱包设置见 rules/getting-started.md。其余细节暂未提供。