GitHub 图像上传

将图像上传至 img402.dev，并将返回的 URL 嵌入 GitHub Markdown 中。

选择套餐

* 服务生命周期内长期保留，但若站点关停将提前 90 天通知 —— 参见《条款》第 2A 节。

快速参考

# 上传（multipart）
curl -s -X POST https://img402.dev/api/free -F image=@/tmp/screenshot.png

# 响应
# {"url":"https://i.img402.dev/aBcDeFgHiJ.png","id":"aBcDeFgHiJ","contentType":"image/png","sizeBytes":182400,"expiresAt":"2026-02-17T..."}

工作流程

1. 获取图像：使用已有文件，或截取屏幕截图：

   screencapture -x /tmp/screenshot.png        # macOS — 全屏截图
   screencapture -xw /tmp/screenshot.png       # macOS — 前置窗口截图
   

2. 验证尺寸：必须小于 1MB。若超出，请调整尺寸：

   sips -Z 1600 /tmp/screenshot.png  # macOS — 将最长边缩放至 1600px
   

3. 上传：

   curl -s -X POST https://img402.dev/api/free -F image=@/tmp/screenshot.png
   

4. 嵌入 返回的 url 到 GitHub Markdown 中：

   ![Screenshot description](https://i.img402.dev/aBcDeFgHiJ.png)
   

GitHub 集成

使用 gh CLI 在 PR 和 issue 中嵌入图像：

# 添加到 PR 描述中
gh pr edit --body "$(gh pr view --json body -q .body)

![Screenshot](https://i.img402.dev/aBcDeFgHiJ.png)"

# 作为 PR 评论添加
gh pr comment --body "![Screenshot](https://i.img402.dev/aBcDeFgHiJ.png)"

# 添加到 issue（编号为 123）
gh issue comment 123 --body "![Screenshot](https://i.img402.dev/aBcDeFgHiJ.png)"

限制条件

• 最大尺寸：1MB
• 保留时长：7 天
• 支持格式：PNG、JPEG、GIF、WebP
• 速率限制：1,000 次免费上传/天（全局）
• 无需身份认证

使用建议

• UI 截图推荐使用 PNG（文字更清晰），照片推荐使用 JPEG。
• 若截图过大，可在上传前使用 sips -Z 1600 缩减图像尺寸。
• 向 PR 正文或评论中添加图像时，请使用 gh pr comment 或 gh pr edit 命令配合图像 Markdown 语法。

付费套餐

如需上传更大尺寸或更长期保留的图像，请通过 x402 支付获取上传 token，再使用该 token 进行上传：

# 第一步：获取上传 token
POST https://img402.dev/api/upload/token            # $0.01 USDC → 1 年保留期
POST https://img402.dev/api/upload/token/permanent  # $1.00 USDC → 永久保留期
# → {"token": "a1b2c3...", "expiresAt": "..."}

# 第二步：使用 token 上传
curl -s -X POST https://img402.dev/api/upload 
  -H "X-Upload-Token: a1b2c3..." 
  -F image=@/tmp/screenshot.png
# → {"url":"...", "expiresAt":"..."|null}   # null 表示永久保留

x402 支付由支持 x402 的客户端处理（例如 Payments MCP 工具、@x402/client 或类似工具）。详见 https://img402.dev/blog/paying-x402-apis。