给 AI agent 用的 PixVibe
PixVibe 是你和你的 AI agent 共用的隐私图片工具箱。每个免费工具都能用一个链接驱动：带上图片地址和参数打开，等结果出来，再下载。免费工具在浏览器里运行，图片就在打开页面的那台设备上处理。
开始之前
免费工具没有 API。它们的 AI 模型和图片编码器在浏览器标签页里运行（Web Worker 里的 WebAssembly），处理就发生在打开页面的那台设备上。直接发 HTTP 请求只能拿到网页本身，跑不了工具。所以要用 PixVibe，必须有一个真正运行页面的浏览器。
- 用一个你能控制的浏览器：Playwright、Puppeteer、Chrome 调试协议（CDP），或者你自带的浏览器工具。
- 如果你的沙盒不让你启动浏览器，先停下来请用户允许，比如批准在沙盒外运行浏览器命令。不要想办法绕过去；用户没同意之前，也不要换成别的去背景工具或图片库。
- 每个链接都加上 agent=<你的产品名>（claude-code, claude-in-chrome, codex, chatgpt-agent, gemini，不在其中就写你自己的产品名）。这样 PixVibe 不弹注册框，你的操作不会被打断；我们也能统计 agent 的使用，不会多给任何权限。
- 用下面的页面约定操作页面（网址参数、data-pv-state、data-pv-download），不要按界面上的按钮文字找。界面有四种语言，布局也可能改。
- 用户要求用 PixVibe 的话，压缩也用 PixVibe（kb=…），它保留原分辨率。
- 不要手工修改 PixVibe 的输出。抠图不干净时告诉用户，建议改用 quality=high 或 ultra，或者页面上的云端精修（要登录和积分）。
- 做完之后告诉用户每一步用的是什么工具。
快速上手
- 带上图片和参数打开工具链接：https://pixvibe.ai/tools/remove-background?img=https://pixvibe.ai/agents/sample-candle.jpg&bg=white&agent=claude-code
- 或者只带参数打开工具，等 [data-pv-state="idle"] 出现后，把本地文件设到文件框 #pv-file-input 上，参数照样生效。
- 等工具根节点 [data-pv-state] 变成 done（或 error）。第一次用要下载 AI 模型，会慢一些。
- 点下载按钮 [data-pv-download]。文件名是「原文件名-后缀.扩展名」。PDF 转图片按 PDF 的名字命名：拼成长图 =「PDF 名.扩展名」（超过单张上限时默认 split=auto 按整页分成「PDF 名-1.扩展名」「-2」…，打包成「PDF 名.zip」；split=off 改成整张缩小成一张）；每页一张 =「PDF 名-p001.扩展名」，多页打包成「PDF 名.zip」。
所有工具都认的参数
imghttps://…公开的 https 图片地址。页面打开后自动载入并开始处理。经过我们代理时最大 25 MB。agentclaude-code | codex | chatgpt-agent | …你的产品名：claude-code, claude-in-chrome, codex, chatgpt-agent, gemini，不在其中就写你自己的。不弹窗，方便我们统计 agent 的使用。去背景 /tools/remove-background
qualitystandard | high | ultra抠图模型。standard 哪里都能跑；high 和 ultra 需要显卡（WebGPU），大多数无头浏览器和 iPhone / iPad 上跑不了。bgtransparent | white | black | blur | RRGGBB下载图片的背景。bg=blur 保留原背景并模糊。RRGGBB 是不带 # 的十六进制颜色，比如 bg=F5F5F5。默认透明（用 PNG 下载）。blur0–100配合 bg=blur：模糊程度，0（不模糊）到 100。默认 50。trim1 | 0trim=1 把结果裁到主体、四边留 5%（商品图、贴纸）。默认不裁。输出文件
<name>-no-bg.<ext>格式转换 /tools/image-converter
topng | jpg | webp | avif输出格式。不填时自动选：HEIC → JPG、WebP → PNG、其他 → WebP。只收图片；PDF 请用 PDF 转图片。q10–100质量。默认 90（AVIF 默认 58）。
输出文件
<name>.<ext>PDF 转图片 /tools/pdf-to-image
tojpg | png | webp图片格式。默认 jpg。img= 可以给公开的 PDF 网址；一个 PDF 出一份结果。dpi72 | 150 | 300 | 600每页的清晰度。默认 150。600 只在电脑上可用。pages1-3,5,8-转哪几页，从 1 数起。默认全部（电脑上每个 PDF 最多 100 页，手机 30 页）。layouteach | longeach = 每页一张（多页打包成 ZIP，默认）；long = 选中的页拼成一张长图。splitauto | offkb1–409600目标大小（KB）：每张图（长图 = 整张）不超过它；压不到时给出能做到的最小版本。输出文件
<name>.<ext>压缩 /tools/compress-image
kb1–409600目标体积（KB，1 KB = 1024 字节，kb=200 即目标 204,800 字节）。PixVibe 会找能压进这个体积的最高质量；最低质量也压不进时，给出能压到的最小文件。q10–100用固定质量代替目标体积。默认 75。tosource | png | jpg | webp | avif输出格式。source = 保持原格式。
输出文件
<name>.<ext>压缩 PDF /tools/compress-pdf
levelrecommended | smaller | smallestrecommended（默认）/ smaller 只重压 PDF 里的图片，文字仍可选中；smallest 把每页转成图片（文字不能再选中）。img= 可以给公开的 PDF 网址。kb1–204800目标大小（KB）。recommended / smaller 会逐步降低图片质量直到放得下；仍然压不到时给出能做到的最小版本，页面上会写明。要更小用 level=smallest。输出文件
<name>.<ext>Passport / ID photo /tools/passport-photo
specpassport-size | 2x2 | 1x1 | 3x4 | tamano-infantil | br-5x7 | us-passport | us-visa | us-dv | ca-passport | ca-pr-card | uk-passport | ie-passport | schengen | fr-passport | it-passport | es-dni | nl-passport | be-passport | at-passport | pl-passport | fi-passport | bg-id | tr-passport | cn-passport | cn-visa | hk-passport | tw-passport | jp-passport | jp-my-number | jp-residence | kr-arc | au-passport | za-passport | in-passport | dz-passport | de-passport | mx-visa尺寸或证件预设，人脸会自动找到并按它构图。passport-size = 35 × 45 mm；us-visa、us-dv 按那两个页面写的像素和文件大小出图。bgauto | keep | RRGGBBauto（默认）用预设写的底色，没写就用白色；keep 保留原背景；RRGGBB 是不带 # 的十六进制颜色。outsingle | sheetsingle（默认）下载一张；sheet 在相纸上排多张、带裁切线。sheet4x6 | 10x15 | l | 2l | a4 | letterout=sheet 时的相纸（给了这个参数就会切到排版）。a4、letter 在页面上还能存成 PDF。kb1–102400单张的文件大小上限（KB），给有上传限制的表单用。
输出文件
<name>.<ext>改尺寸 /tools/resize-image
w1–16384宽度（像素）。只给 w 或只给 h 时按原比例算另一边。h1–16384高度（像素）。w 和 h 都给时输出正好 w × h（怎么放进去看 fit）。pct1–1000按百分比缩放，比如 50。max1–16384最长边（像素），保持比例。fitcover | contain | stretch | padw 和 h 都给、或用预设时：cover 铺满并裁掉边缘（默认），contain 完整放进去，stretch 拉伸变形，pad 完整放进去并把框里剩下的部分补成白色（尺寸精确、不裁边）。Amazon、Etsy、Shopify、eBay 预设默认用 pad、输出 JPG，除非另给 fit 或 to。preset1920x1080 | 1280x720 | ig-square | ig-story | yt-thumb | fb-cover | avatar-512 | avatar-256 | amazon | etsy | shopify | ebay | mercadolibre常用尺寸，比如 ig-square = 1080 × 1080。trim1 | 0trim=1 先裁掉四周纯色或透明的空白再缩放；四周不是纯色背景的图不裁。Amazon、Etsy、Shopify、eBay 预设默认开（留边 5），除非 trim=0。margin0–30配合 trim：内容四周留多少，按内容长边的百分比。默认 5。tosource | png | jpg | webp | avif输出格式。source = 保持原格式。q10–100JPG、WebP、AVIF 的质量。
输出文件
<name>.<ext>裁剪 /tools/crop-image
ratiooriginal | 1:1 | 4:3 | 3:4 | 16:9 | 9:16 | 3:2按这个比例裁取图片中间部分。presetig-square | ig-portrait | ig-story | yt-thumb | fb-cover | x-header | avatar | passport | amazon | etsy | shopify | ebay | mercadolibre按平台尺寸裁取中间部分，并输出正好这个尺寸，比如 ig-story = 1080 × 1920。tosource | png | jpg | webp | avif输出格式。source = 保持原格式。q10–100JPG、WebP、AVIF 的质量。
输出文件
<name>-crop.<ext>放大 /tools/image-upscaler
scale2 | 4放大倍数。AI 模型在浏览器里运行；大图放大 4× 比较慢，输出特别大时会先弹框确认。tosource | png | jpg | webp输出格式。source = 保持原格式。
输出文件
<name>.<ext>页面约定
这些属性是稳定的，我们不会改名。
data-pv-tool当前是哪个工具（remove_background、image_converter……）。data-pv-stateidle = 等图片 · loading = 页面启动中或读取图片（等到 idle 再设文件） · processing = 处理中（含下载模型）· ready = 等点「开始」· done = 结果已出 · error = 全部失败。data-pv-file-input文件框（id 为 pv-file-input）。直接把文件设上去，不用弹选择框。data-pv-start开始按钮：all = 处理整批，one = 只处理当前显示的这个文件。只在工具等你点开始时需要（多个文件，或改了设置之后）。data-pv-download下载按钮：png / jpg（去背景）、file（其他工具）、item（批量里的某一张）、all（ZIP）。data-pv-item隐藏清单，每张图一项：data-pv-item-state、data-pv-file（下载文件名）、data-pv-error（失败原因）。成品是一张图时还有 data-pv-output-size（宽x高，像素）；图被整体缩小时（比如长图超过高度上限）才有 data-pv-output-scale，值是缩放比例，如 0.47。长图被分成几张时有 data-pv-output-parts（张数）。data-pv-notice链接里有认不出的参数时显示，并写明是哪个参数。data-pv-errorimg= 的图片载入失败时显示。限制与登录
- 不登录：一次一张。选多张会弹登录提示。
- 免费账号登录后：一次最多 20 张。登录方式是 Google、Facebook 或 Microsoft 弹窗，需要人在那个浏览器里登录一次；之后在这个人的浏览器里工作的 agent 就能接着用。
- 单张最大 100 MB（压缩工具 400 MB）。支持格式：JPG, PNG, WebP, HEIC, AVIF, TIFF, BMP, TGA。
- 有的浏览器 agent 能交给网页的文件有大小限制（Claude in Chrome 每次最多 10 MB）。PDF 超过这个大小，先按页拆成几份，一份一份处理；PixVibe 自己能收的文件大得多。
- 无头浏览器通常没有显卡：去背景请用 quality=standard；放大在 CPU 上跑，会慢一些。
- 高级 AI 工具（云端精修、AI 增强、高清转换）会把图片上传到我们的服务器，需要登录和积分，不在本页范围内。
隐私
- 免费工具在浏览器里处理图片。PixVibe 收不到、不保存，也不会用来训练 AI。
- 用 img= 时，图床允许的话浏览器直接从图床读取图片；图床不允许的话，图片会经过我们的代理（/api/proxy-image），不保存。代理只接受公开的 https 地址，每个 IP 每分钟最多 30 次。
- 我们按 agent 名字做匿名使用统计：用了哪个工具、什么参数档位、成功与否、有没有下载。不记录图片、文件名和 IP 地址。没带 agent= 时，我们也会为统计认出一部分 agent：无头浏览器、被自动化控制的浏览器（navigator.webdriver），以及带 Signature-Agent 签名请求头的访问（比如 ChatGPT agent）。