Back to Details

image-hosting

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Image Hosting — img402

图片托管服务 — img402

Upload an image to img402.dev and get a public URL. No account, no API key, no config.
将图片上传至img402.dev即可获取公开URL，无需账户、API密钥或配置。

Quick reference

快速参考

bash
undefined
bash
undefined

Upload (multipart)

上传（multipart格式）

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

Response

响应示例

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

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

undefined
undefined

Workflow

操作流程

  1. Get image: Use an existing file, or generate/download one.
  2. Check size: Must be under 1MB. If larger, resize:
    bash
    sips -Z 1600 /path/to/image.png    # macOS — scale longest edge to 1200px
convert /path/to/image.png -resize 1600x1600 /path/to/image.png  # ImageMagick
  3. Upload:
    bash
    curl -s -X POST https://img402.dev/api/free -F image=@/path/to/image.png
  4. Use the URL: The 
    url
    field in the response is a public CDN link. Embed it wherever needed.
  1. 获取图片：使用现有文件，或生成/下载图片。
  2. 检查大小：必须小于1MB。如果过大，请调整尺寸：
    bash
    sips -Z 1600 /path/to/image.png    # macOS系统——将最长边缩放至1600px
convert /path/to/image.png -resize 1600x1600 /path/to/image.png  # ImageMagick工具
  3. 上传图片:
    bash
    curl -s -X POST https://img402.dev/api/free -F image=@/path/to/image.png
  4. 使用URL：响应中的
    url
    字段是公开的CDN链接，可嵌入任何需要的场景。

Constraints

限制条件

  • Max size: 1MB
  • Retention: 7 days
  • Formats: PNG, JPEG, GIF, WebP
  • Rate limit: 1,000 free uploads/day (global)
  • No auth required
  • 最大尺寸：1MB
  • 保留时长：7天
  • 支持格式：PNG、JPEG、GIF、WebP
  • 请求频率限制：每日1000次免费上传（全局限制）
  • 无需认证

Paid tier

付费版

For images that need to persist longer (1 year, 5MB max), use the paid endpoint at $0.01 USDC via x402:
bash
undefined
对于需要长期保存（1年，最大5MB）的图片，可使用付费端点，通过x402支付0.01 USDC：
bash
undefined

Step 1: Get an upload token (requires x402 payment)

步骤1：获取上传令牌（需通过x402支付）

POST https://img402.dev/api/upload/token
POST https://img402.dev/api/upload/token

→ {"token": "a1b2c3...", "expiresAt": "..."}

→ {"token": "a1b2c3...", "expiresAt": "..."}

Step 2: Upload with the token

步骤2：使用令牌上传

curl -s -X POST https://img402.dev/api/upload
-H "X-Upload-Token: a1b2c3..."
-F image=@/path/to/image.png

See https://img402.dev/blog/paying-x402-apis for details on x402 payment.
curl -s -X POST https://img402.dev/api/upload
-H "X-Upload-Token: a1b2c3..."
-F image=@/path/to/image.png

详情请见 https://img402.dev/blog/paying-x402-apis