支付宝小程序API 图片内容安全
my.ap.imgRisk
版本需求：基础库 1.14.0 或更高版本，若版本较低，建议做 兼容处理。
图片风险任务提交接口，用于识别图片是否有色情、违禁违法等内容。有关图片内容安全的产品和接入介绍。
接口说明
此接口为异步请求接口，首先需要发起风险识别请求，获取任务 ID。等待 500 毫秒（ms）后再通过任务 ID 请求结果。
1. 调用参数说明
- 通过传输图片内容判断此图片信息中是否包含风险信息，图片需要传输URL。
- 图片必须是公网可以访问的图片，如果有加密或者限权，则无法返回结果。
2. 返回参数说明
- REJECTED：拒绝，代表此图片风险程度高，不能发布展示。
- PASSED：通过，代表此图片的风险程度低，可以发布展示。
3. 图片风险任务提交
示例代码
my.ap.imgRisk
({pid:'xxxxxxxxxxxxxxxx',
appId:'xxxxxxxxxxxxxxxx',
bizContext:
{"risk_type":"img_risk",
"content": "http://www.xxxxxx.com.cn//xxxxxx/xxxxxxx/images/xxxx/xx/xxx.png"
},
success(e) {
},
})入参
Object 类型，属性如下：
| 属性 | 类型 | 必填 | 描述 |
|---|---|---|---|
| pid | String | 是 | 合作者身份 ID。即商户与支付宝签约后，商户获得的支付宝商户唯一识别码。 |
| appId | String | 是 | 小程序的 APPID。 |
| bizContext | Map | 是 | 需要识别的业务参数。 |
| success | Function | 否 | 调用成功的回调函数。 |
| fail | Function | 否 | 调用失败的回调函数。 |
| complete | Function | 否 | 调用结束的回调函数（调用成功、失败都会执行）。 |
bizContext 属性说明
| 属性 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| risk_type | String | 是 | 1024 | 风险类型。 | 固定传 img_risk |
| content | String | 是 | 128 | 需要验证的图片 URL。 | https://ss1.bdstatic.com/70cFvXSh_Q1YnxGkpoWK1HF6hhy/it/u=3180559933,1841450308&fm=26&gp=0.jpg |
success 回调函数
Object 类型，属性如下：
| 属性 | 类型 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|
| riskResult | String | 128 | 图片风险识别的任务的任务ID。 | \"apply_id\":\"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\ |
| riskResultDesc | String | 1024 | 风险识别结果描述。 | 返回结果会默认为空，忽略即可 |
| success | Boolean | - | 是否调用成功。 | true |
| uniqueId | String | 1024 | 业务唯一识别码。 | xxxxxxxxxxxxxxxxx |
fail 回调函数
Object 类型，属性如下：
| 属性 | 类型 | 描述 |
|---|---|---|
| errorCode | String | 错误码。 |
| errorMessage | String | 错误信息。 |
my.ap.imgRiskCallback
版本需求：基础库 1.14.0 或更高版本，若版本较低，建议做 兼容处理。
查询图片的风险识别结果。有关图片内容安全的产品和接入介绍。
接口说明
此接口为异步请求接口。首先需要发起风险识别请求，获取任务 ID，等待 500 毫秒（ms）后再通过任务 ID 请求结果。
1. 调用参数说明
- 通过传输图片内容判断此图片信息中是否包含风险信息，图片需要传输 URL。
- 图片必须是公网可以访问的图片，如果有加密或者限权，则无法返回结果。
2. 返回参数说明
- REJECTED：拒绝，代表此图片风险程度高，不能发布展示。
- PASSED：通过，代表此图片的风险程度低，可以发布展示。
示例代码
my.ap.imgRiskCallback
({pid:'xxxxxxxxxxxxxxxx',
appId:'xxxxxxxxxxxxxxxx',
bizContext:{
"risk_type": "img_risk_result",
"apply_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
},
success(e) {
},
})入参
Object 类型，属性如下：
| 属性 | 类型 | 必填 | 描述 |
|---|---|---|---|
| pid | String | 是 | 小程序的开放平台账号。 |
| appId | StringArray | 是 | 小程序对应的 APPID。 |
| bizContext | Map | 是 | 需要识别的业务参数。 |
| success | Function | 否 | 调用成功的回调函数。 |
| fail | Function | 否 | 调用失败的回调函数。 |
| complete | Function | 否 | 调用结束的回调函数（调用成功、失败都会执行）。 |
bizContext 属性说明
| 参数 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| risk_type | String | 是 | 1024 | 风险类型。 | 固定传 img_risk_result |
| apply_id | String | 是 | 128 | 需要查询图片的任务 ID。 | 2eee1a72-4f32-45d6-bfa3-0f7173cde80b |
success 回调函数
Object 类型，属性如下：
| 参数 | 类型 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|
| riskResult | String | 128 | 图片风险识别的任务的任务 ID。 | \"action\":\"REJECTED\" \"action\":\"PASSED\" |
| riskResultDesc | String | 1024 | 风险识别结果描述。 | \"REJECTED\":\"拦截\" \"PASSED\":\"放过\ |
| success | Boolean | - | 是否调用成功。 | true |
| uniqueId | String | 1024 | 业务唯一识别码 | 0b92uueie87636222 |
fail 回调函数
Object 类型，属性如下：
| 属性 | 类型 | 描述 |
|---|---|---|
| errorCode | String | 错误码。 |
| errorMessage | String | 错误信息。 |
常见问题
报错说明
| 错误码（errorMessage） | 错误明细 | 解决方案 |
|---|---|---|
| serviceNoAuth | 服务未授权。 | 请检查配置的账户是否已签约响应的功能包。 |
| riskTypeNoAuth | 场景（risktype）未授权。 | 请检查配置的账户是否已签约响应的功能包，请检查 risktype 参数是否正确。 |
| bizContentEmpty | 风险数据内容为空。 | 检查入参数据格式。 |
| paramMissingError | 参数缺失。 | 检查必传参数是否传入。 |
| param error | 参数错误。 | 检查入参格式是否符合文档要求。 |
| SYSTEM_OUT_ERROR | 系统繁忙。 | 请稍后再试。 |
| INVALID_PARAMETER | 缺少必选参数或参数有误。 | 检查参数是否正确或者缺失。 |
| OVER_LIMIT | 超过调用量限制。 | 如需增加额度，请发邮件至 RiskGoCSC@service.alipay.com 进行申请。 |
Q：没有返回识别结果该怎么处理?
A：确认风险识别的任务 ID，为此图片对应的任务 ID。
500ms 后若返回空，建议等待 500ms 后重试。一共重试 3 次，若全为空，尝试重新提交审核任务。
Q：图片说明格式以及大小？
A：
图片格式支持：BMP, PNG, JPEG, TIFF, SVG, ICO
图片大小：0~10MB
图片的 URL 需要可访问。如果出现无法访问，下载失败，非图片格式会返回通过。
Q：调用频率是怎样的？
A：不要并发调用。