htmlcsstoimage

用途：把 HTML/CSS 或公开 URL 渲染成图片，返回一个永久图片链接（经 Cloudflare CDN 提供）。适用场景包括生成社交分享图、OG 图（1200x630）、卡片图、网页截图等。

必要准备：设置环境变量 HCTI_USER_ID 与 HCTI_API_KEY。接口地址为 https://hcti.io/v1/image，使用 curl 以 Basic 认证 POST。

主要能力与用法：

1. HTML 转图片：将 HTML 写入 /tmp/hcti_html.txt，然后运行 curl -s "https://hcti.io/v1/image" -X POST -u "$HCTI_USER_ID:$HCTI_API_KEY" --data-urlencode "html@/tmp/hcti_html.txt"，返回 JSON 中的 url。
2. 带 CSS：追加 --data-urlencode "css@/tmp/hcti_css.txt"。
3. Google Fonts：加 -d "google_fonts=Playfair Display"，多字体用 | 分隔。
4. URL 截图：--data-urlencode "url@/tmp/hcti_url.txt"。
5. JS 渲染延迟：-d "ms_delay=1500"。
6. 指定元素：-d "selector=h1"，支持任意 CSS 选择器。
7. 高分辨率：-d "device_scale=2"（取值 1-3，默认 1）。
8. 自定义视口：-d "viewport_width=1200" -d "viewport_height=630"。
9. 整页截图：-d "full_screen=true"。
10. 屏蔽 cookie 弹窗：-d "block_consent_banners=true"。
11. 下载：图片 URL 加 ?dl=1。
12. 在线缩放：URL 加 ?width=200&height=200。

响应：成功返回 {"url": "..."}；错误返回含 error、statusCode、message 的 JSON。

限制：URL 必须公开，需登录的页面无法截图；使用 --data-urlencode 正确编码 HTML/CSS；JS 重的页面用 ms_delay 等待渲染。计费与配额资料未提供。排障可运行 zero doctor check-connector --env-name HCTI_API_KEY 或 zero doctor check-connector --url https://hcti.io/v1/image --method POST。