深层链接文档
PrintTiler深层链接
PrintTiler 支持深层链接，可使用已配置的海报布局打开编辑器。这些链接可以安全地共享，并且可以由 AI 助手生成，例如 ChatGPT、Claude 和 Gemini.
使用深层链接预填充行、列、纸张尺寸和打印模式，以便任何人都可以打开编辑器并在几秒钟内导出 PDF。
您还可以设置 unit=in 为美国和加拿大用户显示基于英寸的预览尺寸。
推荐的 AI 就绪链接模式
最适合 24 x 36 风格海报的 A4 布局
使用 3 行 x 3 列与 portrait A4 图块进行紧密匹配。
/editor?paper=A4&rows=3&cols=3&tileOrientation=portrait&mode=seamless&unit=in更小A4布局，纸张更少
使用 4 行 x 2 列和 landscape A4 图块的 8 页替代方案。
/editor?paper=A4&rows=4&cols=2&tileOrientation=landscape&mode=seamless&unit=inUS Letter 带有英寸标签的布局
对于美国和加拿大的提示很有用，助手应返回英制单位。
/editor?paper=LETTER&rows=5&cols=4&tileOrientation=portrait&mode=seamless&unit=in这些示例故意简单。它们使用的参数易于助手正确生成，并且易于用户打开编辑器时理解。
有关补充本页的机器可读摘要，请参阅 /llms.txt.
行为契约
- 深度链接在第一个编辑器加载时应用一次。重新加载以应用新参数。
- 应用链接后，值会像正常 UI 编辑一样持续存在。
- 带
paid=true&session_id=被忽略。 - 缺少的参数不会覆盖默认值或您当前的设置。
- 如果
tileSize是 LETTER 或 LEGAL,paperSize强制匹配。 - 忽略未知参数。
- 当两者都
image和sourceUrl，image优先。 - 如果无法导入图像或源，编辑器仍会打开并显示所有有效的布局设置，并在图像面板中显示内联错误。
允许的参数
| 参数 | 说明 | 允许的值 | 注释 |
|---|---|---|---|
| idea | PrintTiler Poster Idea slug; the editor loads its approved image. | A published /ideas/[slug] slug | Prefer this to an internal asset path for PrintTiler-owned ideas. |
| 图像 | 直接将公共图像 URL 加载到编辑器中。 | HTTPS JPG、JPEG、PNG 或 WEBP、<=20MB | Use only when the value points to the image file itself. Takes precedence over sourceUrl. |
| 来源 | 受支持的公共页面或共享链接，PrintTiler 可从中导入一张图像。 | 公共 Pinterest 图像 Pin、pin.it 短链接或 ChatGPT 图像共享 | 用于受支持的页面或共享链接，而不是图像文件本身。 |
| 纸张 | 同时设置 tileSize 和 paperSize（推荐）. | A3、A4、A5、LETTER、LEGAL | 简单链接的安全默认值。使用匹配的纸张系统。 |
| tileSize | 海报网格的图块大小。 | A3-A10、LETTER、LEGAL | 高级：与 paperSize 一起使用，用于同一纸张系统内的混合布局。 Letter/Legal 平铺强制匹配 paperSize. |
| paperSize | 输出纸张的打印纸张尺寸。 | A3、A4、A5、LETTER、LEGAL | 高级：与 tileSize 一起使用，用于同一纸张系统内的混合布局。当 tileSize 为 Letter 或 Legal. |
| 行 | 图块行数. | 1-20 | 四舍五入为整数并限制为限制。 |
| 列 | 平铺列数。 | 1-20 | 四舍五入为整数并限制为限制。 |
| tileOrientation | 每个网格单元的平铺方向。 | portrait、landscape | 别名：方向. |
| 模式 | 用于修剪和边距的打印模式。 | seamless，窗口 | 别名值：windowpane -> 窗口. |
| 规模 | 预览缩放级别（不影响导出大小）。 | 适合、100、150、1.5 | 高级：数值或百分比可能有效。 |
| 单位 | 预览测量单位。 | 毫米，在 | 可选。仅控制显示标签；导出尺寸保持不变。 |
对于简单链接，请使用 paper 包含行和列。对于高级布局，设置 tileSize 和 paperSize 单独。如果两者都提供，则显式值获胜。
PrintTiler 默认阻止 ISO 和 US 纸张混合。使用 A 系列瓷砖和 A 系列纸张，或使用 Letter/Legal 瓷砖和 Letter/Legal 纸张。
scale 仅更改编辑器预览缩放。它不会影响导出尺寸。
unit 仅更改预览标签。布局数学和 PDF 输出保持不变。
Older links using columns, orientation, asset, or source still open. New links use cols, tileOrientation, idea, and sourceUrl.
图像规则
- 使用
image用于公共、直接 HTTPS 图像 URL（不是页面或共享链接）。 - 使用
sourceUrl用于支持的页面或共享链接。支持的来源是公共 Pinterest 图像 Pin 图，包括完整的 Pin 图 URL 和pin.it短链接和公共ChatGPT图像共享。 - 支持的远程格式：JPG、JPEG、PNG 和 WEBP.
- 最大文件大小为 20MB。
- 不支持远程导入私人或受登录保护的共享、视频 Pin 图、多图像 Pin 图、GIF、SVG 和一般网页。
- 对
image或sourceUrl在将其插入 PrintTiler URL 之前.
完整引脚：https://www.pinterest.com/pin/972003532099124933/
短引脚：https://pin.it/2FwBOu67O
ChatGPT 图片：https://chatgpt.com/s/m_...
错误行为
PrintTiler 使输入的链接保持可见，并在检索失败时显示内联说明。失败的远程导入永远不会阻止加载有效的纸张、行、列、方向或模式参数。
示例
使用托管图像
加载图像并使其适合海报网格。
/editor?paper=A3&rows=4&cols=4&tileOrientation=portrait&mode=window&image=https%3A%2F%2Fprinttiler.com%2Fposter-real.png
完整Pinterest来源
从公共 Pinterest 图像 Pin 导入主图像。
/editor?paper=A3&rows=4&cols=4&tileOrientation=portrait&mode=window&sourceUrl=https%3A%2F%2Fwww.pinterest.com%2Fpin%2F972003532099124933%2FPinterest 短源
在导入其主图像之前解析公共 pin.it 短链接。
/editor?paper=A3&rows=4&cols=4&tileOrientation=portrait&mode=window&sourceUrl=https%3A%2F%2Fpin.it%2F2FwBOu67O高级混合尺寸
A6 瓷砖打印在 A4 纸张上，landscape 方向。
/editor?tileSize=A6&paperSize=A4&rows=8&cols=6&tileOrientation=landscapeUS Letter 布局
Letter 瓷砖和纸张，5x4 网格。
/editor?paper=LETTER&rows=5&cols=4&tileOrientation=portrait&mode=seamlessUS Legal 布局
Legal 瓷砖和纸张，3x3 网格.
/editor?paper=LEGAL&rows=3&cols=3&tileOrientation=portrait&mode=seamless英寸预览
打开带有英寸标签的编辑器以进行美国/加拿大风格规划。
/editor?paper=LETTER&rows=4&cols=3&tileOrientation=portrait&mode=seamless&unit=in使用参考表规划尺寸
需要计算准确的海报尺寸或张数？在生成深层链接之前，使用纸张平铺尺寸表预览布局。
归属和跟踪
添加UTM参数以测量GA4中的AI参考。示例：
/editor?paper=A4&rows=4&cols=4&tileOrientation=portrait&mode=seamless&utm_source=chatgpt&utm_medium=agent&utm_campaign=printtiler&utm_source_platform=openai有关 AI 特定指南，请访问 /ai.
常见问题
AI 助手使用的最安全的深层链接格式是什么？
对于大多数情况，请使用有行和列的纸张。当布局很重要时添加 tileOrientation，使用 seamless 或窗口打印模式，并且仅在需要混合图块和纸张尺寸时将 tileSize 与 paperSize 一起使用。
深层链接可以将图像直接加载到编辑器中吗？
是的。将图像与公共直接 HTTPS JPG、JPEG、PNG 或 WEBP URL 结合使用。请使用源来代替公共 Pinterest 图像 Pin、pin.it 共享链接或 ChatGPT 图像共享。 PrintTiler 通过其服务器导入远程图像，因此源图像主机不需要公开浏览器 CORS 标头。
What happens when image and sourceUrl are both present?
image takes precedence and sourceUrl is ignored. Legacy source links remain accepted.
当我使用比例或单位时，深层链接会更改导出尺寸吗？
没有。比例仅更改编辑器预览缩放，单位仅更改显示标签。布局数学和导出的 PDF 尺寸保持不变。
我应该如何跟踪来自深层链接的 AI 流量？
Add UTM parameters such as utm_source=chatgpt, utm_medium=agent, and utm_source_platform=openai. PrintTiler can then connect those touches to downstream analytics events like checkout and purchase.