异步获取图像安全分数
接口地址
https://api.steamdata.cloud.cubicnode.com/service-api/image-moderation/get-image-score-async
此接口用于提交图片进行异步检测,返回图片的安全分数。
接口调用说明
- 图片的文件大小推荐小于 5MB(最大大小取决于相应的服务资源)
- 推荐图片分辨率大于 512x512
- 推荐使用 jpeg, png, webp 格式的图片
- 上传必须使用 form-data 格式和 post 方法
调用方式
POST
请求参数
参数名称 | 参数类型 | 是否必填 | 参数校验规则 | 参数说明 |
---|---|---|---|---|
image | file | 是 | 只能包含字母、数字、下划线、连字符、点号,且图片名称长度不能超过 128 个字符 | 需要检测的图片 |
callback_url | string | 是 | 必须具有有效的 A 或 AAAA 记录 | 接收信息回调地址,审核过程中产生的所有结果发送至此地址 |
marker_id | string | 是 | 只能包含字母、数字、下划线、连字符,且长度不能超过 255 个字符 | 标识 id,对请求进行标识,在回调中会返回对应的标识 id |
- 当
callback_url
的响应出现错误时,将会使用退避算法进行重试,最多重试 5 次,每次重试的时间间隔为重试次数 * 5
秒。
请求示例
POST /service-api/image-moderation/get-image-score-async HTTP/1.1
Request Headers:
Host: api.safeimages.com
Accept: */*
Authorization: SD1-HMAC-SHA256 Credential=012345ABCDEFGHJKLNMOPQRSTU/20240101/ap-east-1/service/sd1_request,SignedHeaders=host;x-sd-api-version;x-sd-datetime,Signature=1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef
Content-Type: multipart/form-data; boundary=-----------------xxxxxxxxxxxxxxxxx
X-SD-Instance-Id: 12345678-1234-1234-1234-123456789012
X-SD-Api-Version: 1.0
X-SD-Datetime: 20240101T173850Z
...
Request Body:
image: <image>
callback_url: https://example.com/callback
marker_id: 12345678-1234-1234-1234-123456789012
响应示例
json
{
"code": "00000",
"message": "Request successful",
"data": {}
}
回调请求示例
json
{
"message": "success",
"code": 00000,
"data": {
"marker_id": "12345678-1234-1234-1234-123456789012",
"safe_score": 0.90,
"unsafe_score": 0.10
}
}