视频加水印 - Img Open

请求参数

Header 参数

X-Request-req-accessKeyId

string

可选

X-Request-req-accessKeySecret

string

可选

Body 参数application/json

businessTaskId

string

任务ID

必需

videoUrl

string

视频url

必需

callbackUrl

string

回调地址

必需

ext

string

待处理视频类型后缀

必需

范围{'mp4','avi','mov','.webm'}；需要基于此进行中间处理

staticText

string | null

静态文本水印内容

可选

staticWatermarkUrl

string | null

静态图片水印url

可选

带域名，完整的url

dynamicText

string | null

动态文本水印内容

可选

dynamicWatermarkUrl

string | null

动态图片水印url

可选

带域名，完整的url

staticTextFixBottom

boolean

静态文本水印是否固定在底部

可选

开启后，静态文本水印会固定在视频底部，static_text_region_num失效

staticTextRegionNum

integer

静态文本水印添加区域

可选

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

staticFontSize

integer

静态文本水印大小

可选

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

staticTextTransparency

number

静态文本水印透明度

可选

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

staticColor

array[integer]

静态文本水印颜色

可选

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

staticImageFixBottom

boolean

静态图片水印是否固定在底部

可选

开启后，静态图片水印会固定在视频底部，static_image_region_num失效

staticImageRegionNum

integer

静态图片水印添加区域

可选

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

staticImageTransparency

number

静态图片水印透明度

可选

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

staticScalingRatio

number

静态图片水印缩放比例

可选

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

dynamicFontSize

integer

动态文本水印大小

可选

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

dynamicColor

array[integer]

动态文本水印颜色

可选

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

dynamicTextTransparency

number

动态图片水印透明度

可选

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

dynamicTextSpeed

integer

动态文本水印速度

可选

范围[20,100]，精度1；动态文本水印每帧移动的像素值，数值越大速度越快

dynamicTextMarginRatio

number

动态文本水印不出现边缘区域比例

可选

范围[0.1,0.25]，精度0.01；限制动态文本水印出现的中心区域的范围，0.1表示四边10%的区域动态水印不会出现

dynamicImageTransparency

number

动态图片水印透明度

可选

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

dynamicScalingRatio

number

动态图片水印缩放比例

可选

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

dynamicImageSpeed

integer

动态图片水印速度

可选

范围[20,100]，精度1；动态文本水印每帧移动的像素值，数值越大速度越快

dynamicImageMarginRatio

number

动态图片水印不出现边缘区域比例

可选

范围[0.1,0.25]，精度0.01；限制动态文本水印出现的中心区域的范围，0.1表示四边10%的区域动态水印不会出现

示例

{
  "businessTaskId": "test111",
  "staticText": "这是一个水印",
  "videoUrl": "video/hgpx-v-240426-1_1_x265.mp4"
}

示例代码

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/video/watermark' \
--header 'X-Request-req-accessKeyId;' \
--header 'X-Request-req-accessKeySecret;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "businessTaskId": "test111",
    "staticText": "这是一个水印",
    "videoUrl": "video/hgpx-v-240426-1_1_x265.mp4"
}'

返回响应

🟢200成功

application/json

Body

code

string

必需

data

object

必需

businessTaskId

string

业务任务id

必需

outputVideoUrl

string

输出视频url

必需

status

integer

任务状态

必需

taskId

string

任务id

必需

videoInfo

object

视频信息

必需

示例

{
  "code": "200",
  "data": {
    "businessTaskId": "test111",
    "outputVideoUrl": "/Output-Img2/zjy/VideoWatermark/pre1723106420682124529514_watermark_634b5d872e964c218ed632d713acb7b7.mp4",
    "status": 2,
    "taskId": "pre1723106420682124529514",
    "videoInfo": {
      "bitrate": 6000,
      "duration": 32.11,
      "format": "mp4",
      "fps": 60,
      "shape": [
        1080,
        1920
      ],
      "size": 93295149
    }
  },
  "msg": "success"
}