API v1
为开发者准备的 API
一次 API 调用即可获得 HTML、CSS、切分图片、结构化 JSON 与质量报告。
01
身份验证
AUTH每个请求都需要 Authorization: Bearer <API_KEY> 头。登录后可在我的工作台签发密钥。
02
转换请求
RECONSTRUCTcURL
curl -X POST https://gumson.com/api/v1/reconstruct \ -H "Authorization: Bearer i2h_your_api_key" \ -F "image_file=@product-page.jpg" \ -F "mode=full" \ -F "format=json"
| 参数 | 类型 | 说明 |
|---|---|---|
| image_file | file | 要转换的图片。JPG、PNG 或 WebP，最大 25 MB。 |
| image_url | string | 可以传入远程图片网址代替 image_file。 |
| mode | string | full（默认）· text · assets |
| format | string | json（默认）· html · zip |
| lang | string | 输出文字的语言。默认与原文相同。 |
| webhook_url | string | 异步任务完成时通知的网址。 |
03
响应
RESPONSEJSON
{
"id": "cnv_9f2a…",
"status": "done",
"sections": 8,
"quality": 94,
"html": "<section class=…>",
"css": ".i2h-hero{…}",
"assets": [
{ "name": "product-01.png", "url": "https://…" }
],
"review_zones": [
{ "y": 4120, "h": 380, "reason": "low_contrast_text" }
]
}
04
状态码
ERRORS| 代码 | 含义 | 处理方式 |
|---|---|---|
| 400 | 请求格式错误 | 请检查参数。 |
| 401 | 身份验证失败 | 请检查 API 密钥。 |
| 402 | 积分不足 | 请检查您的套餐。 |
| 413 | 文件过大 | 请缩减到 25 MB 以下。 |
| 429 | 超过请求频率限制 | 稍等片刻后重试。 |