REST API v1

img2htm API баримт бичиг

Нэг API дуудлагаар зургийг үйлдвэрлэлийн түвшний HTML болго
img2htm API зургийн файл эсвэл URL хүлээн авч HTML, CSS, ялгасан зураг, бүтэцлэгдсэн JSON, чанарын тайлан буцаана.

Эхлэх

img2htm API зургийн файл эсвэл URL хүлээн авч HTML, CSS, ялгасан зураг, бүтэцлэгдсэн JSON, чанарын тайлан буцаана. Сар бүрийн эхний 50 урьдчилан харах дуудлага үнэгүй.

  1. Бүртгэл үүсгэхХяналтын самбараас түлхүүр үүсгэх
  2. POST https://img2htm.com/api/v1/reconstruct with image_file, image_url or image_file_b64.
  3. Receive HTML, CSS, separated assets, structured JSON and a quality report in one response.

Хялбар интеграци

cURL, Node.js, Python, PHP, Ruby, Java, .NET, Swift жишээнүүд.

HTML + CSS + JSON

Нэг API дуудлагаар HTML, CSS, ялгасан зураг, бүтэцлэгдсэн JSON, чанарын тайлан авна.

Кредит гэж юу вэ?

Нэг кредит босоо 15,000 пиксел хүртэлх нэг зургийг бүрэн хөрвүүлнэ. Илүү урт зургийг автоматаар хэд хэдэн кредитээр тооцно. Урьдчилан харах нь үнэгүй.

Баталгаажуулалт

API түлхүүрээ Authorization: Bearer толгой эсвэл X-Api-Key толгойгоор илгээнэ үү.

Authorization: Bearer i2h_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# or
X-Api-Key: i2h_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Жишээ код

curl -X POST https://img2htm.com/api/v1/reconstruct \
  -H "Authorization: Bearer i2h_your_api_key" \
  -F "image_file=@product-page.jpg" \
  -F "mode=full" \
  -F "format=json"

Гаралтын формат

formatТайлбар
jsonDefault. JSON object with html, css, content (structured sections + texts), assets (separated image URLs), quality and urls.
htmlReturns the reconstructed index.html document directly (text/html).
zipStreams a ZIP with index.html, styles.css, content.json, quality.json, sections/ and assets/.

Хариу

{
  "id": "3f9a1c2b7d4e6f80a1b2",
  "status": "done",
  "mode": "full",
  "credits_used": 2,
  "width": 860,
  "height": 24000,
  "sections": 16,
  "quality": {
    "text_accuracy": 97.4,
    "visual_fidelity": 94.1,
    "structure": 95.2,
    "sections": 16,
    "seconds": 41.8,
    "provider": "anthropic:claude-sonnet-5",
    "review": [],
    "auto_pass": true
  },
  "urls": {
    "html": "https://img2htm.com/api/v1/jobs/3f9a1c2b7d4e6f80a1b2/html",
    "zip": "https://img2htm.com/en/convert/3f9a1c2b7d4e6f80a1b2/download",
    "preview": "https://img2htm.com/en/convert/3f9a1c2b7d4e6f80a1b2/preview"
  },
  "assets": ["https://img2htm.com/files/results/3f9a1c2b7d4e6f80a1b2/assets/s01-a01.png"],
  "html": "<!DOCTYPE html> ...",
  "css": "/* img2htm base styles */ ...",
  "content": { "sections": [ ... ], "texts": [ ... ] }
}

API лавлах

Reconstruct an image

POST/api/v1/reconstruct
ПараметрТөрөлТайлбар
image_file заавал*fileMultipart upload. JPG, PNG or WebP, up to 25 MB. *One of image_file, image_url, image_file_b64 is required.
image_urlstringPublic HTTP(S) URL of the image.
image_file_b64stringBase64-encoded image data.
mode сонголтоорfull | previewfull (default) converts the whole image and charges 1 credit per 15,000 vertical px. preview converts only the top 3,000 px for free.
lang сонголтоорstringOutput document language tag: ko, en, cn, tw, ja, mn, ru, th, id, vi, ar. Text is kept in its source language; this sets <html lang>/dir.
format сонголтоорjson | html | zipResponse format (see above).
async сонголтоор1Return 202 Accepted immediately; poll GET /api/v1/jobs/{id} for the result.

Get a job

GET/api/v1/jobs/{id}

Returns the job object. Add ?include_html=1 to embed html, css and content.

Get the HTML document

GET/api/v1/jobs/{id}/html

Returns index.html as text/html.

Account

GET/api/v1/account
{ "email": "you@example.com", "credits": 38, "pixels_per_credit": 15000, "key": "i2h_ab12cd34…", "calls": 1207 }

Хүсэлтийн хязгаар

Минутад 60 зураг per API key. When exceeded the API responds 429 Too Many Requests with a Retry-After: 60 header. Enterprise plans can raise this limit.

Экспоненциал хүлээлт

On 429 or 5xx, retry with exponential backoff: wait 1s, 2s, 4s, 8s … up to 5 attempts, adding random jitter. Never retry 4xx errors other than 429.

delay = min(60, (2 ** attempt) + random(0, 1))

Алдааны кодууд

HTTPТайлбар
400Missing image or unreadable URL.
401Missing, invalid or revoked API key.
402Insufficient credits. Response includes credits_needed and credits_available.
413File exceeds the upload limit.
415Unsupported image type.
429Rate limit exceeded.
500Conversion failed. Credits charged for the job are refunded automatically; error contains the reason.

Сан ба хэрэгслүүд

API өөрчлөлтийн түүх

API өөрчлөлтийн түүх

Пикселд түгжигдсэн вэбээ буцааж ав

Бүртгүүлэхэд үнэгүй кредит. Кредит карт шаардлагагүй.