# 嵌入图片水印预览-byAddress - CreateEmbedImageWatermarkPreviewByAddress
#### 功能介绍
根据提供的图片地址嵌入水印并生成预览。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-dsc/dsc_02_0008.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dsc/dsc_02_0031.html)。
- 如果使用身份策略授权，当前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 | 资源未找到  |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-dsc/ErrorCode.html)。