故障排除

以下按常见程度列出使用中容易遇到的问题。

“Please sign in to use this feature”

所有服务端操作都要求登录 TYO ID。点击右上角的 Sign in。如果登录后仍不断返回未登录状态，请允许 hilia.tyo.com.au 使用 Cookie，因为会话信息保存在 Cookie 中，然后重试。

确定图像含有载荷文件，但 Reveal 失败

常见原因按可能性排序如下：

图像在传输过程中被重新压缩。 聊天或社交平台以内嵌照片形式发送图像时，通常会重新编码，从而清除载荷文件。请让发送者将原图作为文档或文件附件重新发送。绝大多数问题都由此引起。
密码错误。 密码必须完全一致；请向发送者确认。
隐藏文件后又编辑了图像，例如调整尺寸、裁剪、转换格式或截图。
该图像不是隐写图像。 运行 Probe 进行检查。

Hide 返回格式或大小错误

方法与载体格式不匹配 — LSB 方法需要 PNG 或 BMP；JPEG 方法需要 JPEG。参阅选择隐藏方法。
载荷文件太大 — 在 Capacity 面板中检查载体容量；将载荷压缩为 zip，或使用更大的图像。
上传文件太大 — 很大的图像可能超过上传限制；请在隐藏文件之前缩小载体图像，切勿在之后缩小。

“Out of gas”

每次执行水印 Embed 或 Stamp 会消耗 1 Gas。工具页眉中会显示 Gas 余额；可以充值，或成为会员以不限次数地创建水印。失败的操作不会扣除 Gas，充值后重新执行即可。

已加水印的图像无法通过 Detect 检出

确认 **Key（密钥）**完全一致；Detect 只能找到使用该密钥生成的水印。
图像受到的处理可能超过水印的存活能力，例如大幅裁剪、强烈滤镜或缩成极小的缩略图。请提高强度后重新执行 Embed，并测试你的完整流程。

Stamp 标记未在 Reveal preview 中显现

提高 Gain（增益）。如果仍然看不到，经过 Stamp 的图像很可能在之后被重新压缩或调整过尺寸。

API 返回 401 或 429

401 — API 密钥缺失、输入错误或已撤销；请检查你的密钥以及请求头格式（Authorization: Bearer … 或 X-Api-Key: …）。429 — 该密钥已超出月度配额。

其他问题

服务在高负载下偶尔会返回临时错误，可以先重试一次。如果问题仍未解决，请联系我们，并提供所执行的操作、大致时间和错误信息。