用途:render_html_image 用于把浏览器 HTML 与 CSS 组装成像素可控的 PNG。这是显式调用路由:仅当用户明确要求 HTML/CSS 渲染、提供 HTML,或需要基于代码的确定性布局时才使用;单纯要求海报、横幅、社交卡片或品牌图并不构成授权,此时应改用 creativeclaw-generate-image。若用户指定了图像模型,则以该模型为准。
主要能力:适合品牌/主题参考板(精确字体、色板、Logo 位置、示例文案)、确定性的 OG 图、引言卡、标题卡、徽章、对比图、UI 模型,以及需要精确放置文字与图片槽位的可复用布局。可复用参数化布局应改用 create_template 与 render_template。
使用方式:先确认最终像素尺寸、确切可见文案,以及 HTML 由用户提供还是由你编写。品牌类工作先调用 get_theme,用 search_assets 查找已批准的 Logo 与图片,本地或附件媒体需先导入。编写完整固定尺寸布局,将 html、body 边距设为零、隐藏溢出并显式声明字体;Tailwind 工具类无需 CDN 即可使用,普通 <style> 块与 Chromium 中一致。公共图片或字体通过 inline_images 传入,并以 {{token}} 引用,URL 在渲染时必须可公开访问。调用 render_html_image 时传入 html、width、height、有意义的 name 和稳定 tags。渲染同步完成,不要调用 check_job。
限制与注意:不要使用依赖浏览器视口高度或无界文本的内容,应在调用中设定精确画布尺寸并让布局填满。不会注入默认字体,需加载 Web 字体或通过 inline_images 提供持久字体 URL,并始终包含合理回退。远程图片与字体必须可通过 HTTP(S) 访问,不可使用本地路径、blob URL 或不可访问的签名 URL。HTML 渲染能保留 Logo 像素与文案位置,但后续生成模型未必如此;若该 PNG 作为生成参考,需在生成提示中重复确切的品牌与文字约束。渲染后应检查字体加载、文字适配、裁切、对比度与 Logo 保真度。