Skip to content

异步获取图像安全分数

接口地址

https://api.steamdata.cloud.cubicnode.com/service-api/image-moderation/get-image-score-async

此接口用于提交图片进行异步检测,返回图片的安全分数。

接口调用说明

  • 图片的文件大小推荐小于 5MB(最大大小取决于相应的服务资源)
  • 推荐图片分辨率大于 512x512
  • 推荐使用 jpeg, png, webp 格式的图片
  • 上传必须使用 form-data 格式和 post 方法

调用方式

POST

请求参数

参数名称参数类型是否必填参数校验规则参数说明
imagefile只能包含字母、数字、下划线、连字符、点号,且图片名称长度不能超过 128 个字符需要检测的图片
callback_urlstring必须具有有效的 A 或 AAAA 记录接收信息回调地址,审核过程中产生的所有结果发送至此地址
marker_idstring只能包含字母、数字、下划线、连字符,且长度不能超过 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
    }
}