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

Эхлэх

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.

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

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"

import fs from 'node:fs';

const form = new FormData();
form.append('image_file', new Blob([fs.readFileSync('product-page.jpg')]), 'product-page.jpg');
form.append('mode', 'full');

const res = await fetch('https://img2htm.com/api/v1/reconstruct', {
  method: 'POST',
  headers: { Authorization: 'Bearer i2h_your_api_key' },
  body: form,
});
const job = await res.json();
console.log(job.status, job.urls.html);

import requests

with open('product-page.jpg', 'rb') as f:
    r = requests.post(
        'https://img2htm.com/api/v1/reconstruct',
        headers={'Authorization': 'Bearer i2h_your_api_key'},
        files={'image_file': f},
        data={'mode': 'full', 'format': 'json'},
        timeout=600,
    )
job = r.json()
print(job['status'], job['sections'], job['urls']['zip'])

<?php
$ch = curl_init('https://img2htm.com/api/v1/reconstruct');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer i2h_your_api_key'],
  CURLOPT_POSTFIELDS => [
    'image_file' => new CURLFile('product-page.jpg'),
    'mode' => 'full',
  ],
]);
$job = json_decode(curl_exec($ch), true);
file_put_contents('index.html', $job['html']);

require 'net/http'
require 'json'

uri = URI('https://img2htm.com/api/v1/reconstruct')
req = Net::HTTP::Post.new(uri)
req['Authorization'] = 'Bearer i2h_your_api_key'
req.set_form([['image_file', File.open('product-page.jpg')], ['mode', 'full']], 'multipart/form-data')
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
job = JSON.parse(res.body)
puts job['status']

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://img2htm.com/api/v1/reconstruct"))
    .header("Authorization", "Bearer i2h_your_api_key")
    .header("Content-Type", "application/x-www-form-urlencoded")
    .POST(HttpRequest.BodyPublishers.ofString(
        "image_url=https://example.com/page.jpg&mode=full"))
    .build();
HttpResponse<String> res = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization = new("Bearer", "i2h_your_api_key");
using var form = new MultipartFormDataContent();
form.Add(new ByteArrayContent(File.ReadAllBytes("product-page.jpg")), "image_file", "product-page.jpg");
form.Add(new StringContent("full"), "mode");
var res = await http.PostAsync("https://img2htm.com/api/v1/reconstruct", form);
Console.WriteLine(await res.Content.ReadAsStringAsync());

var request = URLRequest(url: URL(string: "https://img2htm.com/api/v1/reconstruct")!)
request.httpMethod = "POST"
request.setValue("Bearer i2h_your_api_key", forHTTPHeaderField: "Authorization")
request.setValue("application/x-www-form-urlencoded", forHTTPHeaderField: "Content-Type")
request.httpBody = "image_url=https://example.com/page.jpg&mode=full".data(using: .utf8)
let (data, _) = try await URLSession.shared.data(for: request)
print(String(data: data, encoding: .utf8)!)

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

Хариу

{
  "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

Get a job

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

Get the HTML document

Returns index.html as text/html.

Account

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

Image generation API

Text-to-image, image variations and rendered translation (the image is redrawn with its text translated). All asynchronous; results are returned as absolute image URLs and can be chained straight into HTML reconstruction.

1) POST /api/v1/images/variations   → 202 { "jobs":[{ "id":"…", "status":"processing", "poll":"…" }] }
2) GET  /api/v1/images/{id}          → { "status":"processing" }   (poll every 3–5 s, usually 40–90 s)
3) GET  /api/v1/images/{id}          → { "status":"done", "images":["https://img2htm.com/files/generated/….jpg"] }
4) POST /api/v1/images/{id}/reconstruct → 202 HTML reconstruction job (poll GET /api/v1/jobs/{id})

Text → image

curl -X POST https://img2htm.com/api/v1/images/generate \
  -H "Authorization: Bearer i2h_your_api_key" -H "Content-Type: application/json" \
  -d '{"prompt":"Minimal skincare product hero shot on white marble, studio light","ratio":"1:1","resolution":"2K"}'

Image → variations

curl -X POST https://img2htm.com/api/v1/images/variations \
  -H "Authorization: Bearer i2h_your_api_key" \
  -F "image_file=@product.jpg" -F "count=2" -F "prompt=same product, night beach background"

Image translation (rendered)

Re-renders the image with every visible text translated into lang (layout, colours and product photos are preserved). Same source parameters as variations plus:

curl -X POST https://img2htm.com/api/v1/images/translate \
  -H "Authorization: Bearer i2h_your_api_key" -H "Content-Type: application/json" \
  -d '{"image_url":"https://example.com/detail-ko.jpg","lang":"ja"}'

Get / list image jobs

{
  "ok": true, "id": "9c1f…", "kind": "variation", "status": "done", "progress": 100,
  "prompt": "same product, night beach background", "ratio": "auto", "resolution": "2K",
  "images": ["https://img2htm.com/files/generated/9c1f…-1.jpg"], "gen_seconds": 71.3,
  "credits_used": 0, "created_at": "2026-09-04 13:20:11", "finished_at": "2026-09-04 13:21:30",
  "poll": "https://img2htm.com/api/v1/images/9c1f…"
}

status: pending → processing → done | failed (error holds the reason; credits are refunded).

Generated image → HTML

Creates a reconstruction job from a finished image (index selects the image, default 0; mode full|preview; lang as in /reconstruct). Returns 202 with the job id — poll GET /api/v1/jobs/{id} like any reconstruction.

Translation · OCR API

Gemini-powered text translation and image OCR (+translation). Synchronous, responds within seconds.

Text translation

curl -X POST https://img2htm.com/api/v1/translate \
  -H "Authorization: Bearer i2h_your_api_key" -H "Content-Type: application/json" \
  -d '{"text":"리뷰티 스튜디오는 이미지 생성 API를 제공합니다.","target_lang":"en"}'
# → { "ok":true, "target_lang":"en", "model":"gemini-…", "translation":"Rebeauty Studio provides an image generation API." }

Image OCR (+ translation)

curl -X POST https://img2htm.com/api/v1/ocr -H "Authorization: Bearer i2h_your_api_key" \
  -F "image_file=@banner.png" -F "translate_to=en"
# → { "ok":true, "text":"…extracted…", "translation":"…" }

Supported language codes and names.

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

Минутад 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))

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

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

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

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