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. 验证尺寸：必须小于 1 MB。若超出，需调整大小：

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

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)"

限制条件

• 最大尺寸：1 MB
• 保留时长：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。