接口基础信息 #

• 请求地址：https://api.postimage.org/1/upload
• 请求方式：POST
• 内容类型：multipart/form-data（必须，适配文件上传场景）

核心参数说明 #

必填参数 #

• file：待上传的图片文件，格式为 @本地文件路径;filename=文件名;type=文件MIME类型，示例：@3.jpg;filename=3.jpg;type=image/jpeg
• key：账号专属API密钥，登录后在API生成页面创建并获取
• o：登录会话校验参数，需从登录后网页的上传请求抓包中提取
• m：同o，属于会话校验类参数，同样从登录后的上传请求中抓取
• upload_session：上传会话标识，登录后发起网页端上传时自动生成，通过抓包获取
• numfiles：本次上传的文件数量，单文件上传场景固定填1

可选参数 #

• expire：图片过期时长，0表示永久有效，其他值为具体秒数（如86400对应1天）
• gallery：目标相册ID，需提前在账号内创建相册，填写相册的唯一标识
• optsize：图片压缩选项，0表示不压缩，其他值对应平台预设压缩等级
• adult：是否标记为成人内容，0表示否，1表示是

使用步骤 #

1. 获取API密钥：登录账号后进入API生成页面，生成并复制你的key
2. 抓取会话参数：登录后在网页端传一张图，用浏览器开发者工具（Network面板）抓包，提取请求里的o、m、upload_session参数
3. 构造请求：用curl或其他HTTP工具构造multipart/form-data请求，填入所有必填参数及需要的可选参数
4. 解析响应：接口返回JSON格式数据，url字段即为图片的访问链接

完整请求示例 #

curl -s -F "file=@3.jpg;filename=3.jpg;type=image/jpeg;" \
    -F "expire=0" \
    -F "gallery=2Bg7L37" \
    -F "key=c3bc40a1134353de9d2db593d5d2534f" \
    -F "o=2b819584285c102318568238c7d4a4c7" \
    -F "m=59c2ad4b46b0c1e12d5703302bff0120" \
    -F "numfiles=1" \
    -F "optsize=0" \
    -F "upload_session=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
    -F "adult=0" https://api.postimage.org/1/upload | jq -r '.url'

注意事项 #

• 会话参数o、m、upload_session会随登录会话过期失效，请求失败时需重新抓包获取
• 确保文件MIME类型与实际格式匹配，否则可能导致上传失败
• 相册IDgallery必须是你账号下已存在的相册，否则图片会默认上传到公共相册

内容的提问来源于stack exchange，提问作者Penguin-senpai