Image Upload for GitHub
Upload an image to img402.dev's free tier and embed the returned URL in GitHub markdown.
Quick reference
CODEBLOCK0
Workflow
- 1. Get image: Use an existing file, or capture a screenshot:
screencapture -x /tmp/screenshot.png # macOS — full screen
screencapture -xw /tmp/screenshot.png # macOS — frontmost window
- 2. Verify size: Must be under 1MB. If larger, resize:
sips -Z 1600 /tmp/screenshot.png # macOS — scale longest edge to 1600px
- 3. Upload:
curl -s -X POST https://img402.dev/api/free -F image=@/tmp/screenshot.png
- 4. Embed the returned
url in GitHub markdown:
CODEBLOCK4
GitHub integration
Use gh CLI to embed images in PRs and issues:
CODEBLOCK5
Constraints
- - Max size: 1MB
- Retention: 7 days — suitable for PR reviews, not permanent docs
- Formats: PNG, JPEG, GIF, WebP
- Rate limit: 1,000 free uploads/day (global)
- No auth required
Tips
- - Prefer PNG for UI screenshots (sharp text). Use JPEG for photos.
- If a screenshot is too large, reduce dimensions with
sips -Z 1600 before uploading. - When adding to a PR body or comment, use
gh pr comment or gh pr edit with the image markdown.
Paid tier
For permanent images (1 year, 5MB max), use the paid endpoint at $0.01 USDC via x402. See https://img402.dev/blog/paying-x402-apis for details.
用于GitHub的图片上传
将图片上传至img402.dev的免费套餐，并将返回的URL嵌入到GitHub Markdown中。
快速参考
bash
上传（多部分表单）
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. 获取图片：使用现有文件，或截取屏幕截图：
bash
screencapture -x /tmp/screenshot.png # macOS — 全屏
screencapture -xw /tmp/screenshot.png # macOS — 最前窗口
- 2. 验证大小：必须小于1MB。若超出，请调整尺寸：
bash
sips -Z 1600 /tmp/screenshot.png # macOS — 将最长边缩放至1600像素
- 3. 上传：
bash
curl -s -X POST https://img402.dev/api/free -F image=@/tmp/screenshot.png
- 4. 嵌入返回的url到GitHub Markdown中：
markdown
GitHub集成
使用gh CLI将图片嵌入PR和Issue中：
bash
添加到PR描述
gh pr edit --body $(gh pr view --json body -q .body)
添加为PR评论
gh pr comment --body
添加到Issue
gh issue comment 123 --body
限制条件
- - 最大尺寸：1MB
- 保留期限：7天 — 适用于PR审查，不适合永久文档
- 格式支持：PNG、JPEG、GIF、WebP
- 速率限制：每天1000次免费上传（全局）
- 无需认证
提示
- - UI截图建议使用PNG格式（文字清晰）。照片建议使用JPEG格式。
- 若截图过大，上传前使用sips -Z 1600缩小尺寸。
- 添加至PR正文或评论时，使用gh pr comment或gh pr edit配合图片Markdown。
付费套餐
如需永久保存图片（1年，最大5MB），可通过x402使用付费接口，费用为0.01 USDC。详情请参阅 https://img402.dev/blog/paying-x402-apis。
