文档首页/ 数据安全中心 DSC/ API参考/ API说明/ 图片水印/ 嵌入图片水印预览-byAddress
更新时间:2025-09-12 GMT+08:00
分享

嵌入图片水印预览-byAddress

功能介绍

根据提供的图片地址嵌入水印并生成预览。

调用方法

请参见如何调用API

URI

POST /v1/{project_id}/watermark/embed/image-address/preview

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

blind_watermark

String

盲水印内容

dst_file

String

目标文件路径

image_watermark

String

图像水印内容

is_blind_mark

Boolean

是否嵌入盲水印

is_visible_mark

Boolean

是否嵌入可见水印

offset_x

Integer

水印水平偏移量

offset_y

Integer

水印垂直偏移量

opacity

Integer

水印透明度

region_id

String

区域ID

src_file

String

源文件路径

text_color

Integer

文本颜色

text_rotation

Integer

文本旋转角度

visible_image_watermark

String

可见图像水印内容

visible_text_watermark

String

可见文本水印内容

visible_watermark_position

String

可见水印位置

visible_watermark_type

String

可见水印类型

watermark_size

Integer

水印大小

响应参数

状态码:200

预览生成成功

状态码:201

预览已生成

请求示例

POST /v1/{project_id}/watermark/embed/image-address/preview

{
  "dst_file" : "obs://autotest-add/dsc_test.png",
  "is_blind_mark" : false,
  "is_visible_mark" : true,
  "offset_x" : 0,
  "offset_y" : 0,
  "opacity" : 50,
  "region_id" : "string",
  "src_file" : "obs://a-real-obs/dsc.png",
  "text_color" : 15688290,
  "visible_text_watermark" : "test",
  "visible_watermark_position" : "CENTER",
  "visible_watermark_type" : "TEXT",
  "watermark_size" : 50
}

响应示例

状态码

状态码

描述

200

预览生成成功

201

预览已生成

401

未授权

403

禁止访问

404

资源未找到

错误码

请参见错误码

相关文档