技能介绍

解决的问题

在真实业务里，图像修改往往不是从零生成，而是对已有素材做定向改造：换背景、放大补细节、把多张图叠成一张。调四个独立 API 不仅要处理不同的 Content-Type 和鉴权，还得在 base64 字符串、文件上传和 HTTPS URL 之间反复切换。Venice 图片编辑把这套操作收敛到四个端点，让 Agent 可以在一个技能里完成“改、合、放、抠”。

核心能力与关键步骤

单图编辑：POST /image/edit 接收 model 与 prompt，输入可以是 base64、file 或 HTTPS URL，适合换风格、补元素、局部重绘。
多图合成：POST /image/multi-edit 使用 modelId（不是 model），一次最多传 3 张图。multipart 变体用同名字段 images 上传多个文件，顺序决定图层先后。
放大与增强：POST /image/upscale 支持 scale 1–4，enhance 可单独开启增强。enhanceCreativity 控制 AI 再创作程度，replication 保留原图线条与噪点。
透明抠图：POST /image/background-remove 二选一传 image 或 image_url，直接输出带 alpha 通道的 PNG。

请求前先确认输入形态：JSON 请求体用 base64 字符串或 URL，multipart 才传原始文件。/image/multi-edit 是唯一要求 modelId 的端点，写错字段名会直接 400。

适用边界与注意点

所有端点都作用于已有图片，文本生成图像请走 venice-image-generate。
/image/upscale 要求输入至少 65536 px²；scale=4 在超大图上会被自动下调以守住 16 MP 上限。
safe_mode 默认开启，若源图触发内容分类器可能被模糊，需要在自控输入时显式关闭。
400/401/402/415/429/5xx 分别对应参数、鉴权、余额、Content-Type、限流与推理故障，排障时先查字段名和请求体形态。
不要把 data:image/...;base64,... 前缀发给 /image/edit 或 /image/upscale；遇到 400 先剥掉前缀再试。