给图片加水印

请求参数

Header 参数

X-Request-req-accessKeyId

string

可选

X-Request-req-accessKeySecret

string

可选

Body 参数application/json

businessTaskId

string

业务任务ID

必需

imageUrl

string

图片url

必需

text

string

文本水印内容

可选

fontSize

integer

文本大小

可选

范围[20,100]，精度1；文本字符高度对应的像素值，最终效果受图片尺寸影响

textRegionNum

integer

文本水印添加区域

可选

范围[1,9]，精度1；将图片分为九宫格，1~9分别对应左上、中上、右上、左中、中中、右中、左下、中下、右下九个区域

textTransparency

integer

文本水印透明度

可选

范围[0,1]，精度0.01；调节文本水印透明度

color

array[integer]

文本水印颜色

可选

默认值为[255,255,255]，即白色

watermarkUrl

string

图片水印的url

可选

imageRegionNum

integer

图片水印添加区域

可选

范围[0,1]，精度0.01；调节图片水印透明度

scalingRatio

integer

图片水印缩放比例

可选

范围[0.25,2.0]，精度0.01；调节图片水印最终大小

imageTransparency

integer

图片水印透明度

可选

范围[0,1]，精度0.01；调节图片水印透明度

ext

string

图片保存格式

可选

范围{'png','jpg','jpeg','webp'}；如果传入的格式不支持，使用默认格式png

callbackUrl

string

回调地址

可选

示例

{
  "businessTaskId": "test111",
  "text": "这是一个水印",
  "imageUrl": "https://dbt-aigc.oss-cn-hangzhou.aliyuncs.com/Output-Img2/zjy/three_test.webp",
  "watermarkUrl": "https://dbt-aigc.oss-cn-hangzhou.aliyuncs.com/Output-Img2/zjy/bali_bao.png",
  "ext": "webp",
  "textTransparency": 1,
  "imageTransparency": 1,
  "scalingRatio": 2,
  "textRegionNum": 2,
  "imageRegionNum": 8
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.zhiqite.com/AIGCImgOpenServ/saas/tool/image/watermark' \
--header 'X-Request-req-accessKeyId;' \
--header 'X-Request-req-accessKeySecret;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "businessTaskId": "test111",
  "text": "这是一个水印",
  "imageUrl": "https://dbt-aigc.oss-cn-hangzhou.aliyuncs.com/Output-Img2/zjy/three_test.webp",
  "watermarkUrl": "https://dbt-aigc.oss-cn-hangzhou.aliyuncs.com/Output-Img2/zjy/bali_bao.png",
  "ext": "webp",
  "textTransparency": 1,
  "imageTransparency": 1,
  "scalingRatio": 2,
  "textRegionNum": 2,
  "imageRegionNum": 8
}'

返回响应

🟢200成功

application/json

Body

code

string

必需

msg

string

必需

data

object

必需

businessTaskId

string

业务任务id

必需

outputImageUrl

string

输出图片url

必需

status

integer

任务状态

必需

taskId

string

任务id

必需

imageInfo

object

图片信息

必需

示例

{
  "code": "string",
  "msg": "string",
  "data": {
    "businessTaskId": "string",
    "outputImageUrl": "string",
    "status": 0,
    "taskId": "string",
    "imageInfo": {
      "format": "string",
      "shape": [
        0
      ],
      "size": 0
    }
  }
}