图片水印

接口标识: imagewatermark 价格: 0.08 元/次同步响应

接口介绍
接口文档
在线测试

接口简介

图片水印接口为图片自动加盖文字或图片水印：文字水印支持中文，颜色与字号可调；图片水印按底图宽度占比等比缩放，适配各种分辨率。位置支持九宫格、居中与全图平铺，平铺模式可有效防裁剪去除；透明度 0~1、旋转角度 -180~180 度均可调节。底图最大 50MB，产物保持底图原尺寸。适合电商主图版权保护、图库试看防盗用与设计稿交付签收等场景。

详细介绍

![图片水印接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261111/apiops_imagewatermark__1794363355_7e0ecefcbaa6.png)

原创图片与设计稿不加标识容易被转载盗用，用修图软件逐张加水印又费时费力。图片水印接口自动为图片盖上文字或图片水印，还能全图平铺防裁剪。

## 接口概述
面向电商、图库、设计服务与内容平台等场景，上传底图并选择文字或图片水印，接口自动完成水印生成、缩放、旋转、透明度混合与定位贴合，返回加水印后的图片地址。文字水印支持中文，服务器内置中文字体，颜色与字号可调；图片水印按底图宽度占比等比缩放。位置支持九宫格、居中与全图平铺；底图最大 50MB，EXIF 方向自动纠正，产物保持底图原始尺寸。处理结果可直接用于详情页发布、作品交付与图库展示。

## 核心能力
1. **双水印类型**：文字水印（100 字符内、支持中文）与图片水印（建议透明底 PNG 标志）二选一。
2. **定位灵活**：九宫格 1~9 号位、center 居中或 tile 全图平铺，默认右下角；平铺模式让裁剪去水印无从下手。
3. **外观可调**：透明度 0~1、旋转角度 -180~180 度、文字颜色与字号（8~300 像素）均可自定义。
4. **等比缩放**：图片水印按底图宽度的 5%~90% 占比缩放（默认 20%），底图分辨率变化时水印比例自动适配。
5. **品质保障**：底图 EXIF 方向自动纠正，产物以 PNG 无损格式输出，尺寸与底图一致。

## 产品优势
1. **接入简单**：一次 POST 传底图与水印参数即得产物地址，无需安装图像处理库。
2. **响应迅速**：水印合成在平台服务器本地完成，无需等待第三方服务。
3. **稳定可靠**：无外部依赖即无上游抖动风险；底图与水印图分别有 50MB 与 10MB 大小校验。
4. **准确规范**：中文字体服务器内置，中文文字水印不会出现乱码或缺字。
5. **降本增效**：替代修图软件手工加水印，批量图片保护可全自动化。
6. **生态开放**：与平台其余接口共用同一套签名与响应结构，接入一次处处复用。

## 效果展示
一句话理解：它就像给图片盖「防盗章」，你说盖什么字、盖在哪、盖多大、多淡，它一下就盖好还你成图。

以一次真实调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| file | https://example.com/demo/poster.jpg | 底图，支持公网URL、Base64（data:开头）与平台文件ID（fileid_开头），不超过 50MB |
| watermark_type | text | 水印类型：text 文字 / image 图片 |
| text | 网程聚合数据 | 水印文字，text 类型时必填，100 字符内，支持中文 |
| position | 9 | 九宫格位置 1~9（9 为右下），也支持 center 居中与 tile 全图平铺，默认 9 |
| opacity | 0.4 | 透明度 0~1，默认 0.5，数值越小水印越淡 |
| font_size | 48 | 文字字号（像素），默认 32，范围 8~300 |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 加水印后的图片地址 | https://fujian.phpwc.com/pyapi/uploads/api/20261110/wm_20261110_170000.png | `image_url`，产物为 PNG 格式 |
| 产物宽度 | 1920 | `width`，与底图一致 |
| 产物高度 | 1080 | `height`，与底图一致 |

API请求示例：

```text
POST /api/imagewatermark
file=https://example.com/demo/poster.jpg&watermark_type=text&text=网程聚合数据&position=9&opacity=0.4&font_size=48
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "image_url": "https://fujian.phpwc.com/pyapi/uploads/api/20261110/wm_20261110_170000.png",
    "width": 1920,
    "height": 1080
  },
  "request_id": "req-imagewatermark-demo-001"
}
```

本例在 1920×1080 的海报右下角盖了一枚四成透明度的文字水印；改用图片水印时传 watermark_type=image 并提供 watermark_file，其余定位与外观参数用法相同。

## 应用场景
1. **电商防盗图**：商品主图与细节图加盖品牌文字或标志，防止同行搬运。
2. **图库运营**：试看大图批量加半透明水印，购买后再提供无水印原图。
3. **设计交付**：发给客户的方案稿加盖「确认稿」标识，定稿后再交付无水印版本。
4. **内容平台**：用户发布的原创图片自动附加作者署名水印，便于维权溯源。
5. **证照资料**：证件与合同翻拍件批量加注「仅供某项业务使用」字样，防止挪用。

## 应用案例
一家摄影工作室每次交片要发带水印的预览图，此前助理用修图软件逐张处理，一批照片要花不少时间；接入接口后交付系统自动在右下角盖工作室署名文字，当天即可发预览，客户留存截图也无法直接盗用。

一家原创设计素材站需要为免费试看图加满版水印防裁剪盗用；现在统一使用 tile 平铺模式配合较低透明度，素材展示清晰又难以二次去除，付费下载的转化更加稳定。

一家物业公司要求业主上传的房产资料照片加注「仅供入住办理使用」，业主自行修图困难；改为小程序调用接口自动加文字水印后，业主直接拍照上传即可，资料被挪用的风险随之消除。

常见问题

Q：文字水印支持中文吗？会不会乱码？

A：支持。服务器内置中文字体，中英文文字水印均可正常渲染，文字长度不超过 100 字符。

Q：图片水印的大小怎么控制？

A：按 scale 参数以底图宽度占比缩放，范围 0.05~0.9，默认 0.2；高度按水印图原比例自适应，底图分辨率变化时水印占比保持一致。

Q：如何防止别人裁剪掉水印？

A：把 position 设为 tile，水印会以平铺方式重复覆盖整张图片，配合合适的透明度即可兼顾展示效果与防裁剪。

Q：产物格式和尺寸有变化吗？

A：产物统一输出 PNG 格式，宽高与底图一致；底图带 EXIF 旋转信息时会自动纠正为正确方向。

图片水印文字水印 logo水印版权保护平铺水印

接口地址： https://www.phpwc.cn/api/imagewatermark

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`file`	file	必填	-	底图，图片/文件，支持三形态：公网URL / data:image;base64编码 / file_id(fileid_开头)
`watermark_type`	string	必填	-	水印类型：text / image
`text`	string	选填	-	水印文字（text 时必填，≤100 字符）
`watermark_file`	file	选填	-	水印图片（image 时必填，建议 PNG 透明底），图片/文件，支持三形态：公网URL / data:image;base64编码 / file_id(fileid_开头)
`position`	string	选填	-	位置：1~9 九宫格 / center / tile，默认 9（右下）
`opacity`	number	选填	-	透明度 0~1，默认 0.5
`scale`	number	选填	-	水印相对底图宽度占比 0.05~0.9，默认 0.2（image 生效）
`rotate`	int	选填	-	旋转角度 -180~180，默认 0
`color`	string	选填	-	文字颜色 hex，默认 #FFFFFF
`font_size`	int	选填	-	文字字号（像素），默认 32

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`image_url`	string	产物图片下载地址
`width`	int	产物宽度（像素）
`height`	int	产物高度（像素）
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试