GetImageDetectionTaskResult - 查询图片检测任务结果
查询图片检测任务的状态和结果,包括AIGC检测标签和篡改检测结果。
接口说明
请求说明
调用本接口可以查询通过 CreateImageDetectionTask 创建的异步检测任务的执行状态和结果。建议以 2~5 秒的间隔轮询,直到任务状态变为 succeeded 或 failed。
注意事项
请确保使用有效的
TaskId进行查询。如果任务尚未完成,请适当增加轮询间隔时间,避免频繁请求导致资源浪费。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
aideepsign:GetImageDetectionTaskResult |
get |
*全部资源
|
无 | 无 |
请求语法
GET HTTP/1.1
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| ClientToken |
string |
否 |
用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一。 |
5A2CFF0E-5718-45B5-9D4D-70B3FF3898 |
| TaskId |
string |
是 |
任务 ID,由 |
f47ac10b-58cc-4372-a567-0e02b2c3d479 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
请求 ID。 |
A1B2C3D4-E5F6-7890-ABCD-EF1234567890 |
| TaskId |
string |
任务 ID。 |
f47ac10b-58cc-4372-a567-0e02b2c3d479 |
| Success |
boolean |
请求是否成功。 |
|
| DetectMode |
string |
实际执行的检测模式。取值:
仅在 |
tamper |
| Labels |
array<object> |
检测结果标签列表。仅在 Status 为 succeeded 且包含 AIGC 检测时返回。标签取值与置信度范围随 DetectMode 不同:aigc 模式返回 AIGC 生成鉴别标签(见下表),tamper 模式返回 aigc / aips 标签(置信度 0~1)。 |
|
|
object |
|||
| Label |
string |
检测标签。DetectMode=aigc 时取值:risk_aigc(图片疑似 AIGC 生成)、risk_fake(图片疑似为合成图片)、risk_edit(图片疑似为 AI 编辑图片);DetectMode=tamper 时取值:aigc(AIGC 检测得分)、aips(AI 后处理检测得分)。 |
risk_aigc |
| Confidence |
number |
置信度,取值范围 0~1。 |
0.9562 |
| Message |
string |
附加信息。请求成功时返回 |
success |
| HttpStatusCode |
integer |
HTTP 状态码。请求成功时返回 |
200 |
| Code |
string |
业务错误码。请求成功时返回 |
OK |
| Tamper |
object |
篡改检测结果。仅在 DetectMode 为 tamper 或为空时返回。 |
|
| BaseResults |
object |
基础检测结果,包含多维度检测得分。 |
|
| Aigc |
object |
AIGC 检测得分。 |
|
| Score |
number |
AIGC 检测得分,范围 0~1,值越高表示 AI 生成可能性越大。 |
0.47 |
| Desc |
string |
AIGC 检测结果描述。 |
疑似AI生成图片 |
| Aips |
object |
AI 后处理检测得分。 |
|
| Score |
number |
AI 后处理检测得分,范围 0~1,值越高表示 AI 后处理可能性越大。 |
0.12 |
| Desc |
string |
AI 后处理检测结果描述。 |
未发现AI后处理痕迹 |
| PsLoc |
object |
PS 篡改定位结果。 |
|
| Items |
array<object> |
篡改区域列表。 |
|
|
object |
|||
| Bbox |
array |
篡改区域边界框坐标,格式为 |
|
|
number |
篡改区域边界框坐标 |
[120.0, 80.0, 350.0, 260.0] |
|
| Score |
number |
该区域的篡改置信度,范围 |
0.67 |
| Desc |
string |
PS 篡改定位结果描述。 |
发现1处疑似PS修改区域 |
| ImgType |
string |
图片类型。 |
natural |
| LlmResult |
string |
大模型综合分析结果。 |
该图片经检测存在AI生成痕迹,AIGC检测得分0.95,建议进一步核实图片来源。 |
| Status |
string |
任务状态。取值:
|
succeeded |
示例
正常返回示例
JSON格式
{
"RequestId": "A1B2C3D4-E5F6-7890-ABCD-EF1234567890",
"TaskId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"Success": true,
"DetectMode": "tamper",
"Labels": [
{
"Label": "risk_aigc",
"Confidence": 0.9562
}
],
"Message": "success",
"HttpStatusCode": 200,
"Code": "OK",
"Tamper": {
"BaseResults": {
"Aigc": {
"Score": 0.47,
"Desc": "疑似AI生成图片"
},
"Aips": {
"Score": 0.12,
"Desc": "未发现AI后处理痕迹"
},
"PsLoc": {
"Items": [
{
"Bbox": [
0
],
"Score": 0.67
}
],
"Desc": "发现1处疑似PS修改区域"
},
"ImgType": "natural"
},
"LlmResult": "该图片经检测存在AI生成痕迹,AIGC检测得分0.95,建议进一步核实图片来源。"
},
"Status": "succeeded"
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | IdempotentParameterMismatch | The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical. |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。