GetImageDetectionTaskResult - 查询图片检测任务结果

更新时间:
复制 MD 格式

查询通过CreateImageDetectionTask创建的图片检测任务的状态和结果。

接口说明

请求说明

调用本接口可以查询指定图片检测任务的执行状态及结果,包括 AIGC 检测标签和篡改检测结果。建议以 2~5 秒的间隔轮询,直到任务状态变为 succeeded 或 failed。

注意事项

  • 请确保使用有效的 TaskId 进行查询。

  • 如果任务尚未完成,请适当增加轮询间隔时间,避免频繁请求导致资源浪费。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

aideepsign:GetImageDetectionTaskResult

get

*全部资源

*

请求语法

GET  HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

ClientToken

string

用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一。ClientToken 只支持 ASCII 字符,且不能超过 64 个字符。

5A2CFF0E-5718-45B5-9D4D-70B3FF3898

TaskId

string

任务 ID,由 CreateImageDetectionTask 返回。

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

实际执行的检测模式。取值:

  • aigc(仅 AIGC)

  • tamper(篡改检测)

仅在 Statussucceeded 时返回。

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"。任务失败时的错误信息。仅在 Statusfailed 时返回。

success

HttpStatusCode

integer

HTTP 状态码。请求成功时返回 200

200

Code

string

业务错误码。请求成功时返回 "OK"

OK

Tamper

object

篡改检测结果

BaseResults

object

基础算法检测结果,包含多维度检测得分与风险标签。

Aigc

object

AIGC 检测

Score

number

AIGC 检测得分,范围 0~1,值越高表示 AI 生成可能性越大。

0.47

Desc

string

AIGC 检测结果描述。

疑似AI生成图片

Risk

string

AIGC 维度风险标签

高风险

Aips

object

AI 后处理检测得分。

Score

number

AI 后处理检测得分,范围 0~1,值越高表示 AI 后处理可能性越大。

0.12

Desc

string

AI 后处理检测结果描述。

未发现AI后处理痕迹

Risk

string

局部 PS/AI 编辑维度风险标签。

高风险

PsLoc

object

PS 篡改定位结果。

Items

array<object>

篡改区域列表。

object

Bbox

array

篡改区域边界框坐标,格式为 [x1, y1, x2, y2]

number

篡改区域边界框坐标

[120.0, 80.0, 350.0, 260.0]

Score

number

该区域的篡改置信度,范围 0~1

0.67

Desc

string

PS 篡改定位结果描述。

发现1处疑似PS修改区域

Recap

object

翻拍/复印检测

Score

number

翻拍/复印检测得分,范围 0~1,值越高表示翻拍/复印可能性越大。

0.9998

Desc

string

翻拍/复印检测结果描述。

翻拍检测分数

Risk

string

翻拍/复印维度风险标签。

高风险

ImgType

string

图片类型。

natural

LlmResult

string

大模型综合分析结果。

该图片经检测存在AI生成痕迹,AIGC检测得分0.95,建议进一步核实图片来源。

RiskLevel

string

判定结果。必有。

高风险

FinalConclusion

string

最终结论。

核验到元数据分析结果为高风险

AiWatermark

string

AI 明水印。仅大模型模式产出,小模型模式为空。

MetadataAiFlag

string

元数据 AI 标识。必有。

高风险

MetadataAiSource

string

元数据 AI 标识来源。仅大模型模式产出,小模型模式为空。

通义

Status

string

任务状态。取值:

  • pending(等待中)

  • running(执行中)

  • succeeded(已完成)

  • failed(失败)

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生成图片",
        "Risk": "高风险"
      },
      "Aips": {
        "Score": 0.12,
        "Desc": "未发现AI后处理痕迹",
        "Risk": "高风险"
      },
      "PsLoc": {
        "Items": [
          {
            "Bbox": [
              0
            ],
            "Score": 0.67
          }
        ],
        "Desc": "发现1处疑似PS修改区域"
      },
      "Recap": {
        "Score": 0.9998,
        "Desc": "翻拍检测分数",
        "Risk": "高风险"
      },
      "ImgType": "natural"
    },
    "LlmResult": "该图片经检测存在AI生成痕迹,AIGC检测得分0.95,建议进一步核实图片来源。",
    "RiskLevel": "高风险",
    "FinalConclusion": "核验到元数据分析结果为高风险",
    "AiWatermark": "是",
    "MetadataAiFlag": "高风险",
    "MetadataAiSource": "通义"
  },
  "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.

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情