API v1
An API for developers
One API call returns HTML, CSS, extracted images, structured JSON and a quality report.
01
Authentication
AUTHEvery request needs an Authorization: Bearer <API_KEY> header. Issue a key from your Workspace after signing in.
02
Conversion request
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"
| Parameter | Type | Description |
|---|---|---|
| image_file | file | Image to convert. JPG, PNG or WebP, up to 25 MB. |
| image_url | string | A remote image URL can be passed instead of image_file. |
| mode | string | full (default) · text · assets |
| format | string | json (default) · html · zip |
| lang | string | Language of the output text. Defaults to the original. |
| webhook_url | string | URL to notify when an async job completes. |
03
Response
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
Status codes
ERRORS| Code | Meaning | What to do |
|---|---|---|
| 400 | Malformed request | Check the parameters. |
| 401 | Authentication failed | Check your API key. |
| 402 | Insufficient credits | Check your plan. |
| 413 | File too large | Reduce it to 25 MB or less. |
| 429 | Rate limit exceeded | Retry after a short wait. |