fix: harden compression boundaries and target search

frontend/src/pages/DocsPage.vue

@@ -19,9 +19,10 @@
       <ul class="mt-2 list-disc space-y-1 pl-5">
         <li>Base URL：<code>https://ys.workyai.cn/api/v1</code></li>
         <li>认证方式：<code>X-API-Key</code>（推荐）或 <code>Authorization: Bearer &lt;token&gt;</code></li>
-        <li>支持格式：PNG / JPG / JPEG / WebP / AVIF / GIF（静态）/ BMP / TIFF / ICO（支持 output_format 转码）</li>
+        <li>支持格式：PNG / JPG / JPEG / WebP / AVIF / GIF / BMP / TIFF / ICO（仅静态图片，支持 output_format 转码）</li>
         <li>压缩率：<code>compression_rate</code> 1-100；JPEG/WebP/AVIF 以该比例为体积上限，无损格式为尽力优化</li>
-        <li>计量：成功压缩 1 个文件计 1 次；若体积未变小或压缩率为 100，则不扣额度</li>
+        <li>目标体积：<code>target_size_bytes</code> 仅支持 JPEG/WebP/AVIF，且不能与 <code>compression_rate</code> 同时提交</li>
+        <li>计量：输出体积变小时计 1 次；仅同格式、无缩放的 <code>compression_rate=100</code> 原样请求免计量</li>
       </ul>
     </div>
 
@@ -40,6 +41,7 @@
   https://ys.workyai.cn/api/v1/compress</code></pre>
       <div class="mt-3 text-xs text-slate-500">
         返回字段包含 <code>download_url</code>、<code>saved_percent</code> 与 <code>billing.units_charged</code>。
+        目标小于清晰度保护边界时返回 <code>INVALID_REQUEST</code>，不会返回超过目标的文件。
       </div>
     </div>
 
@@ -95,6 +97,7 @@ curl -H "X-API-Key: if_live_xxx" \
       <div class="font-medium text-slate-900">错误处理与常见问题</div>
       <ul class="mt-2 list-disc space-y-1 pl-5">
         <li><code>INVALID_REQUEST</code>：参数或文件不合法（检查格式与字段）</li>
+        <li><code>UNSUPPORTED_FORMAT</code>：不支持该格式或输入为动画图片</li>
         <li><code>QUOTA_EXCEEDED</code>：额度不足（升级套餐或等待周期重置）</li>
         <li><code>FORBIDDEN</code>：无权限下载该任务/文件（认证不一致）</li>
         <li><code>EMAIL_NOT_VERIFIED</code>：登录用户需先完成邮箱验证</li>