Image Worker

Image Worker 执行像素级合成。它不接受公开客户端请求，也不保存跨请求状态。

Worker v2

POST /worker/v2/render 接收一个源资源、多个图层和输出配置：

{
  "version": 1,
  "resource": { "resourceToken": "<source-resource-token>" },
  "layers": [],
  "output": { "format": "png", "quality": 90 }
}

源图片和图片图层都通过固定 RESOURCE_SERVICE_URL 获取，调用方不能指定 URL。响应是 image/jpeg、image/png 或 image/webp 字节流。

渲染能力

• EXIF 方向校正。
• 图片和文字混合图层。
• 稳定的 zIndex 与请求顺序。
• 图片按宽、高或宽高缩放。
• 九宫格锚点和绝对坐标。
• 图层整体旋转、透明度、阴影和平铺。
• Noto Sans CJK SC 中文字体。

容量与错误

Worker 使用非排队并发闸门。达到 IMAGE_RENDER_CONCURRENCY 时立即返回 429 WORKER_BUSY，避免请求在进程内无限排队。资源过期、格式非法、结果超限和调用取消都会终止当前 Sharp 管线。

兼容接口

POST /worker/v1/render 接受 multipart 文件与 JSON 字符串，仅支持旧文字水印模型，已经弃用。新功能只在 Worker v2 演进。

健康与能力

GET /worker/v1/health/live
GET /worker/v1/health/ready
GET /worker/v1/capabilities