وثائق API الخاصة بـ img2htm

البدء

تستقبل واجهة 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