请求方式POST
API 地址-
鉴权请求头X-Api-Key: 实例密钥
curl -X POST '<API 地址>' \
-H 'Content-Type: application/json' \
-H 'X-Api-Key: <实例密钥>' \
-d '{"task_id":"20260820120000_a1b2c3",
"source":{"bucket":"xxx","object_key":"2026/08/20/xxx.jpg"},
"watermark":{"enabled":true,"showCode":true,"showTime":true,"showDate":true,
"showProject":true,"showOperator":true,"position":"bottom-right",
"sizePercent":12,"opacity":51,"bgColor":"#373434","textColor":"#FFFFFF",
"lineGapPercent":15,"primaryGapPercent":0,"borderRadius":9,
"layout":"vertical","textAlign":"left",
"primaryFontScale":22,"secondaryFontScale":16,
"customText":"本系统由玖乐智远科技提供技术支持",
"info":{"code":"435316043781541","time":"18:36:02","date":"2026-08-18","project":"项目名","operator":"操作人"}},
"thumbnail":{"width":240,"quality":80}}'
响应:{code:0, url, thumb_url, width, height, ms};失败 code 非 0 带 msg。url 需在实例里配置"访问基地址"才会拼接返回。每个实例一把专属密钥,只能处理所属实例的桶。限流 120 次/分钟。