path: root/data/zh_cn/aideepsign/2026-05-11/api-docs.php

<?php return [
    'version' => '1.0',
    'info' => ['style' => 'RPC', 'product' => 'AIDeepSign', 'version' => '2026-05-11'],
    'directories' => ['CreateImageTask', 'CreateSensitiveScanTask', 'DetectAigcImage', 'GetImageTaskResult', 'GetSensitiveScanResult', 'VerifyImageSignature', 'SignUserImage', 'DetectImageBasicInfo', 'CreateImageDetectionTask', 'GetImageDetectionTaskResult'],
    'components' => [
        'schemas' => [],
    ],
    'apis' => [
        'CreateImageDetectionTask' => [
            'summary' => '创建异步图片检测任务，支持AIGC和篡改检测。',
            'path' => '',
            'methods' => ['get', 'post'],
            'schemes' => ['https'],
            'security' => [
                [
                    'AK' => [],
                ],
            ],
            'operationType' => 'write',
            'deprecated' => false,
            'systemTags' => [
                'operationType' => 'create',
                'riskType' => 'none',
                'chargeType' => 'free',
                'abilityTreeNodes' => ['FEATUREkms586TOR'],
                'tenantRelevance' => 'publicInformation',
            ],
            'parameters' => [
                [
                    'name' => 'ClientToken',
                    'in' => 'query',
                    'allowEmptyValue' => false,
                    'schema' => ['title' => '幂等参数', 'description' => '用于保证请求的幂等性。由客户端生成该参数值，要保证在不同请求间唯一。`ClientToken` 只支持 ASCII 字符，且不能超过 64 个字符。'."\n", 'type' => 'string', 'required' => false, 'example' => '5A2CFF0E-5718-45B5-9D4D-70B3FF3898'],
                ],
                [
                    'name' => 'ObjectKey',
                    'in' => 'query',
                    'schema' => ['description' => '待检测图片在 OSS 中的 `ObjectKey`。使用 `ObjectKey` 时需确保该 Key 属于当前调用者的命名空间。`ImageUrl` 与 `ObjectKey` 二选一，至少提供一个。'."\n", 'type' => 'string', 'required' => false, 'example' => 'deepsign/123456789/scan/abc12345.jpg'],
                ],
                [
                    'name' => 'ImageUrl',
                    'in' => 'query',
                    'schema' => ['description' => '待检测图片的 URL 地址，仅支持 HTTP/HTTPS 协议。`ImageUrl` 与 `ObjectKey` 二选一，至少提供一个。'."\n", 'type' => 'string', 'required' => false, 'example' => 'https://example.com/id-card.jpg'],
                ],
                [
                    'name' => 'DetectType',
                    'in' => 'query',
                    'schema' => ['description' => '检测类型。取值：`auto`（自动，默认）、`aigc`（仅 AIGC 检测）、`tamper`（凭证篡改检测）。', 'type' => 'string', 'required' => false, 'example' => 'auto'],
                ],
                [
                    'name' => 'CredType',
                    'in' => 'query',
                    'schema' => ['description' => '该参数已废弃', 'type' => 'string', 'required' => false, 'example' => 'deprecated'],
                ],
            ],
            'responses' => [
                200 => [
                    'schema' => [
                        'title' => 'Schema of Response',
                        'description' => '返回参数包括请求 ID 和任务 ID，用于调用 `GetImageDetectionTaskResult` 查询结果。'."\n",
                        'type' => 'object',
                        'properties' => [
                            'RequestId' => ['title' => 'Id of the request', 'description' => '请求 ID。'."\n", 'type' => 'string', 'example' => 'A1B2C3D4-E5F6-7890-ABCD-EF1234567890'],
                            'Success' => ['description' => '请求是否成功。'."\n", 'type' => 'boolean'],
                            'Message' => ['description' => '附加信息。请求成功时返回 `success`。'."\n", 'type' => 'string', 'example' => 'success'],
                            'HttpStatusCode' => ['description' => 'HTTP 状态码。请求成功时返回 `200`。'."\n", 'type' => 'string', 'example' => '200'],
                            'Code' => ['description' => '业务错误码。请求成功时返回 `OK`。'."\n", 'type' => 'string', 'example' => 'OK'],
                            'TaskId' => ['description' => '任务 ID，用于调用 `GetImageDetectionTaskResult` 查询结果。'."\n", 'type' => 'string', 'example' => 'f47ac10b-58cc-4372-a567-0e02b2c3d479'],
                        ],
                    ],
                ],
            ],
            'errorCodes' => [
                400 => [
                    ['errorCode' => 'IdempotentParameterMismatch', 'errorMessage' => '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.', 'description' => ''],
                ],
            ],
            'staticInfo' => ['returnType' => 'synchronous'],
            'title' => '创建图片检测任务',
            'description' => '## 请求说明'."\n"
                .'- 本接口用于创建一个异步的图片检测任务，支持自动分类、AIGC检测及篡改检测。'."\n"
                .'- `ImageUrl` 和 `ObjectKey` 必须至少提供一个；如果同时提供，则优先使用 `ObjectKey`。'."\n"
                .'- 当选择 `DetectType` 为 `auto` 时，系统将根据图片内容自动决定执行 AIGC 检测还是篡改检测。',
            'changeSet' => [],
            'responseDemo' => '[{"errorExample":"","example":"{\\n  \\"RequestId\\": \\"A1B2C3D4-E5F6-7890-ABCD-EF1234567890\\",\\n  \\"Success\\": true,\\n  \\"Message\\": \\"success\\",\\n  \\"HttpStatusCode\\": \\"200\\",\\n  \\"Code\\": \\"OK\\",\\n  \\"TaskId\\": \\"f47ac10b-58cc-4372-a567-0e02b2c3d479\\"\\n}","type":"json"}]',
        ],
        'CreateImageTask' => [
            'methods' => ['get', 'post'],
            'schemes' => ['https'],
            'security' => [
                [
                    'AK' => [],
                ],
            ],
            'operationType' => 'write',
            'deprecated' => false,
            'systemTags' => [
                'operationType' => 'create',
                'riskType' => 'none',
                'chargeType' => 'free',
                'abilityTreeNodes' => ['FEATUREkms586TOR'],
                'tenantRelevance' => 'publicInformation',
            ],
            'parameters' => [
                [
                    'name' => 'ClientToken',
                    'in' => 'query',
                    'allowEmptyValue' => false,
                    'schema' => ['title' => '幂等参数', 'description' => '用于保证请求的幂等性。由客户端生成该参数值，要保证在不同请求间唯一。`ClientToken` 只支持 ASCII 字符，且不能超过 64 个字符。'."\n", 'type' => 'string', 'required' => false, 'example' => '5A2CFF0E-5718-45B5-9D4D-70B3FF3898'],
                ],
                [
                    'name' => 'Prompt',
                    'in' => 'query',
                    'schema' => ['title' => '图片描述文字（正向提示词），不超过800字符', 'description' => '图片描述文字（正向提示词），不超过 800 字符。'."\n", 'type' => 'string', 'required' => false, 'example' => '一间全是猫的会议室'],
                ],
                [
                    'name' => 'NegativePrompt',
                    'in' => 'query',
                    'schema' => ['title' => '反向提示词，不超过500字符', 'description' => '反向提示词，不超过 500 字符。'."\n", 'type' => 'string', 'required' => false, 'example' => '低质量,模糊,变形'],
                ],
                [
                    'name' => 'Model',
                    'in' => 'query',
                    'schema' => ['title' => '模型名称，默认qwen-image-2.0-pro', 'description' => '模型名称，默认 `qwen-image-2.0-pro`。'."\n", 'type' => 'string', 'required' => false, 'example' => 'qwen-image-2.0-pro'],
                ],
                [
                    'name' => 'Size',
                    'in' => 'query',
                    'schema' => ['title' => '图片尺寸（格式 宽*高），默认2048*2048', 'description' => '图片尺寸（格式 宽高），默认 `20482048`。'."\n", 'type' => 'string', 'required' => false, 'example' => '1024*1024'],
                ],
                [
                    'name' => 'N',
                    'in' => 'query',
                    'schema' => ['title' => '生成数量（1-6），默认1', 'description' => '生成数量（1~6），默认 `1`。'."\n", 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1'],
                ],
                [
                    'name' => 'Seed',
                    'in' => 'query',
                    'schema' => ['title' => '随机种子（0-2147483647），0表示随机', 'description' => '随机种子（0~2147483647），0 表示随机。'."\n", 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '42'],
                ],
                [
                    'name' => 'PromptExtend',
                    'in' => 'query',
                    'schema' => ['title' => '是否开启提示词智能改写，默认true', 'description' => '是否开启提示词智能改写，默认true', 'type' => 'boolean', 'required' => false],
                ],
            ],
            'responses' => [
                200 => [
                    'schema' => [
                        'title' => 'Schema of Response',
                        'description' => 'Schema of Response',
                        'type' => 'object',
                        'properties' => [
                            'RequestId' => ['title' => 'Id of the request', 'description' => '请求 ID。'."\n", 'type' => 'string', 'example' => 'A1B2C3D4-E5F6-7890-ABCD-EF1234567890'],
                            'TaskId' => ['title' => '任务ID，用于查询生成结果', 'description' => '任务 ID，用于调用 `GetImageTaskResult` 查询结果。'."\n", 'type' => 'string', 'example' => 'f47ac10b-58cc-4372-a567-0e02b2c3d479'],
                            'Success' => ['description' => '表示是否调用成功。true：调用成功。                                 false：调用失败。', 'type' => 'boolean'],
                            'Message' => ['description' => '附加信息。请求成功时返回 `success`。'."\n", 'type' => 'string', 'example' => 'success'],
                            'HttpStatusCode' => ['description' => 'HTTP 状态码。请求成功时返回 `200`。'."\n", 'type' => 'integer', 'format' => 'int32', 'example' => '200'],
                            'Code' => ['description' => '业务错误码。请求成功时返回 `OK`。'."\n", 'type' => 'string', 'example' => 'OK'],
                        ],
                    ],
                ],
            ],
            'errorCodes' => [
                400 => [
                    ['errorCode' => 'IdempotentParameterMismatch', 'errorMessage' => '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.', 'description' => ''],
                ],
            ],
            'staticInfo' => ['returnType' => 'synchronous'],
            'title' => '创建图片生成任务',
            'summary' => '根据提供的文字描述生成图片，并返回任务ID。',
            'description' => '## 请求说明'."\n"
                .'- 本接口用于创建AI图片生成任务，系统将依据用户提供的正向提示词（Prompt）生成相应的图片。'."\n"
                .'- 支持配置反向提示词、模型选择、图片尺寸等参数以优化生成效果。'."\n"
                .'- 默认情况下，生成的图片会自动嵌入C2PA数字签名；可选是否添加右下角水印。'."\n"
                .'- 通过设置`ClientToken`参数可以保证请求的幂等性，确保在不同请求间唯一。'."\n"
                .'- 创建任务后，使用`TaskId`调用`GetImageTaskResult`接口查询生成结果。'."\n",
            'changeSet' => [],
            'responseDemo' => '[{"errorExample":"","example":"{\\n  \\"RequestId\\": \\"A1B2C3D4-E5F6-7890-ABCD-EF1234567890\\",\\n  \\"TaskId\\": \\"f47ac10b-58cc-4372-a567-0e02b2c3d479\\",\\n  \\"Success\\": true,\\n  \\"Message\\": \\"success\\",\\n  \\"HttpStatusCode\\": 200,\\n  \\"Code\\": \\"OK\\"\\n}","type":"json"}]',
        ],
        'CreateSensitiveScanTask' => [
            'summary' => '用于创建图片敏感信息扫描任务并返回任务ID。',
            'methods' => ['get', 'post'],
            'schemes' => ['https'],
            'security' => [
                [
                    'AK' => [],
                ],
            ],
            'operationType' => 'write',
            'deprecated' => false,
            'systemTags' => [
                'operationType' => 'create',
                'riskType' => 'none',
                'chargeType' => 'free',
                'abilityTreeNodes' => ['FEATUREkms586TOR'],
                'tenantRelevance' => 'publicInformation',
            ],
            'parameters' => [
                [
                    'name' => 'ClientToken',
                    'in' => 'query',
                    'allowEmptyValue' => false,
                    'schema' => ['title' => '幂等参数', 'description' => '用于保证请求的幂等性。由客户端生成该参数值，要保证在不同请求间唯一。`ClientToken` 只支持 ASCII 字符，且不能超过 64 个字符。'."\n", 'type' => 'string', 'required' => false, 'example' => '5A2CFF0E-5718-45B5-9D4D-70B3FF3898'],
                ],
                [
                    'name' => 'ObjectKey',
                    'in' => 'query',
                    'schema' => ['title' => 'OSS文件路径', 'description' => '待扫描图片在 OSS 中的 `ObjectKey`。使用 `ObjectKey` 时需确保该 Key 属于当前调用者的命名空间。`ImageUrl` 与 `ObjectKey` 二选一，至少提供一个。'."\n", 'type' => 'string', 'required' => false, 'example' => 'deepsign/123456789/scan/abc12345.jpg'],
                ],
                [
                    'name' => 'ImageUrl',
                    'in' => 'query',
                    'schema' => ['description' => '待扫描图片的 URL 地址，仅支持 HTTP/HTTPS 协议。图片大小不超过 10 MB。`ImageUrl` 与 `ObjectKey` 二选一，至少提供一个。'."\n", 'type' => 'string', 'required' => false, 'example' => 'https://example.com/document.jpg'],
                ],
            ],
            'responses' => [
                200 => [
                    'schema' => [
                        'title' => 'Schema of Response',
                        'description' => 'Schema of Response',
                        'type' => 'object',
                        'properties' => [
                            'RequestId' => ['title' => 'Id of the request', 'description' => '请求 ID。'."\n", 'type' => 'string', 'example' => 'A1B2C3D4-E5F6-7890-ABCD-EF1234567890'],
                            'TaskId' => ['description' => '任务 ID，用于调用 `GetSensitiveScanResult` 查询结果。'."\n", 'type' => 'string', 'example' => 'f47ac10b-58cc-4372-a567-0e02b2c3d479'],
                            'Success' => ['description' => '表示是否调用成功。true：调用成功。                                 false：调用失败。', 'type' => 'boolean', 'example' => 'True'],
                            'Message' => ['description' => '附加信息', 'type' => 'string', 'example' => 'null'],
                            'HttpStatusCode' => ['description' => 'HTTP状态码。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'],
                            'Code' => ['description' => '内部错误码。', 'type' => 'string', 'example' => 'OK'],
                        ],
                    ],
                ],
            ],
            'errorCodes' => [
                400 => [
                    ['errorCode' => 'IdempotentParameterMismatch', 'errorMessage' => '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.', 'description' => ''],
                ],
            ],
            'staticInfo' => ['returnType' => 'synchronous'],
            'title' => '创建敏感信息扫描任务',
            'description' => '## 请求说明'."\n"
                .'- 本接口用于创建图片敏感信息扫描任务，系统将对指定的图片进行敏感数据识别。'."\n"
                .'- 支持通过图片URL或OSS ObjectKey指定待扫描图片。'."\n"
                .'- 图片大小不能超过10MB。'."\n"
                .'- `ImageUrl`和`ObjectKey`必须至少提供一个；如果两个都提供，则优先使用`ObjectKey`。'."\n"
                .'- 使用`ObjectKey`时，需确保该Key属于当前调用者的命名空间，不允许跨租户访问。'."\n"
                .'- 可以通过`ClientToken`参数保证请求的幂等性。'."\n",
            'changeSet' => [],
            'responseDemo' => '[{"errorExample":"","example":"{\\n  \\"RequestId\\": \\"A1B2C3D4-E5F6-7890-ABCD-EF1234567890\\",\\n  \\"TaskId\\": \\"f47ac10b-58cc-4372-a567-0e02b2c3d479\\",\\n  \\"Success\\": true,\\n  \\"Message\\": \\"null\\",\\n  \\"HttpStatusCode\\": 200,\\n  \\"Code\\": \\"OK\\"\\n}","type":"json"}]',
        ],
        'DetectAigcImage' => [
            'methods' => ['get', 'post'],
            'schemes' => ['https'],
            'security' => [
                [
                    'AK' => [],
                ],
            ],
            'operationType' => 'read',
            'deprecated' => false,
            'systemTags' => [
                'operationType' => 'get',
                'riskType' => 'none',
                'chargeType' => 'free',
                'abilityTreeNodes' => ['FEATUREkms586TOR'],
                'tenantRelevance' => 'publicInformation',
            ],
            'parameters' => [
                [
                    'name' => 'ObjectKey',
                    'in' => 'query',
                    'schema' => ['description' => '待检测图片在 OSS 中的 ObjectKey。使用 ObjectKey 时需确保该 Key 属于当前调用者的命名空间。ImageUrl 与 ObjectKey 二选一，至少提供一个。'."\n", 'type' => 'string', 'required' => false, 'example' => 'deepsign/123456789/image-generation/abc12345-def6-7890-abcd-ef1234567890.png'],
                ],
                [
                    'name' => 'ImageUrl',
                    'in' => 'query',
                    'schema' => ['description' => '待检测图片的 URL 地址，仅支持 HTTP/HTTPS 协议。`ImageUrl` 与 `ObjectKey` 二选一，至少提供一个。'."\n", 'type' => 'string', 'required' => false, 'example' => 'https://example.com/photo.jpg'],
                ],
            ],
            'responses' => [
                200 => [
                    'schema' => [
                        'title' => 'Schema of Response',
                        'description' => 'Schema of Response',
                        'type' => 'object',
                        'properties' => [
                            'RequestId' => ['title' => 'Id of the request', 'description' => '请求 ID。'."\n", 'type' => 'string', 'example' => 'A1B2C3D4-E5F6-7890-ABCD-EF1234567890'],
                            'Body' => [
                                'description' => 'AIGC 检测结果标签列表。'."\n",
                                'type' => 'array',
                                'items' => [
                                    'type' => 'object',
                                    'properties' => [
                                        'Label' => ['description' => '**检测标签**。取值：'."\n"
                                            .'- `ai_generated`（AI 生成）'."\n"
                                            .'- `non_ai_generated`（非 AI 生成）'."\n", 'type' => 'string', 'example' => 'ai_generated'],
                                        'Confidence' => ['description' => '**置信度**，取值范围 0~1，值越大表示可能性越高。'."\n", 'type' => 'string', 'example' => '0.51'],
                                    ],
                                    'description' => '',
                                ],
                            ],
                            'Success' => ['description' => '表示是否调用成功。true：调用成功。                                 false：调用失败。', 'type' => 'boolean'],
                            'Message' => ['description' => '附加信息。请求成功时返回 `success`。'."\n", 'type' => 'string', 'example' => 'success'],
                            'HttpStatusCode' => ['description' => 'HTTP 状态码。请求成功时返回 `200`。'."\n", 'type' => 'integer', 'format' => 'int32', 'example' => '200'],
                            'Code' => ['description' => '业务错误码。请求成功时返回 `OK`。'."\n", 'type' => 'string', 'example' => 'OK'],
                        ],
                    ],
                ],
            ],
            'errorCodes' => [
                400 => [
                    ['errorCode' => 'IdempotentParameterMismatch', 'errorMessage' => '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.', 'description' => ''],
                ],
            ],
            'staticInfo' => ['returnType' => 'synchronous'],
            'title' => '检测AI生成图片',
            'summary' => '判断图片是否由AI生成，并返回检测标签及置信度。',
            'description' => '## 请求说明'."\n"
                .'- 本接口用于检测指定图片是否为AI生成内容（AIGC），支持通过图片URL或OSS ObjectKey指定待检测图片。'."\n"
                .'- ImageUrl和ObjectKey必须至少提供一个，如果两个都提供，则优先使用ObjectKey。'."\n"
                .'- 使用ObjectKey方式时，系统会校验该ObjectKey是否属于当前调用者，不允许跨租户访问。'."\n"
                .'- 该接口为同步接口，适合对单张图片进行实时检测。如果需要异步检测或同时进行凭证检测，请使用CreateImageDetectionTask接口。'."\n",
            'changeSet' => [],
            'responseDemo' => '[{"errorExample":"","example":"{\\n  \\"RequestId\\": \\"A1B2C3D4-E5F6-7890-ABCD-EF1234567890\\",\\n  \\"Body\\": [\\n    {\\n      \\"Label\\": \\"ai_generated\\",\\n      \\"Confidence\\": \\"0.51\\"\\n    }\\n  ],\\n  \\"Success\\": true,\\n  \\"Message\\": \\"success\\",\\n  \\"HttpStatusCode\\": 200,\\n  \\"Code\\": \\"OK\\"\\n}","type":"json"}]',
        ],
        'DetectImageBasicInfo' => [
            'methods' => ['post'],
            'schemes' => ['https'],
            'security' => [
                [
                    'AK' => [],
                ],
            ],
            'operationType' => 'read',
            'deprecated' => false,
            'systemTags' => [
                'operationType' => 'get',
                'riskType' => 'none',
                'chargeType' => 'free',
                'abilityTreeNodes' => ['FEATUREkms586TOR'],
                'autoTest' => true,
                'tenantRelevance' => 'publicInformation',
            ],
            'parameters' => [
                [
                    'name' => 'ImageUrl',
                    'in' => 'query',
                    'schema' => ['description' => '图片的 URL 地址，仅支持 HTTP/HTTPS 协议。`ImageUrl` 与 `ObjectKey` 二选一，至少提供一个。'."\n", 'type' => 'string', 'required' => false, 'example' => 'https://example.com/photo.jpg'],
                ],
                [
                    'name' => 'ObjectKey',
                    'in' => 'query',
                    'schema' => ['description' => '图片在 OSS 中的 `ObjectKey`。使用 `ObjectKey` 时需确保该 Key 属于当前调用者的命名空间。`ImageUrl` 与 `ObjectKey` 二选一，至少提供一个。'."\n", 'type' => 'string', 'required' => false, 'example' => 'deepsign/123456789/image-generation/abc12345-def6-7890-abcd-ef1234567890.png'],
                ],
            ],
            'responses' => [
                200 => [
                    'schema' => [
                        'type' => 'object',
                        'properties' => [
                            'Type' => ['description' => '图片格式，如 JPEG、PNG、GIF、WEBP 等。无法识别时返回 `UNKNOWN`。'."\n", 'type' => 'string', 'example' => 'PNG'],
                            'RequestId' => ['description' => '请求 ID。'."\n", 'type' => 'string', 'example' => 'A1B2C3D4-E5F6-7890-ABCD-EF1234567890'],
                            'Size' => ['description' => '文件大小（人类可读格式），如 1.5 MB、256 KB。'."\n", 'type' => 'string', 'example' => '2.3 MB'],
                            'Dpi' => ['description' => '图片分辨率（宽 * 高），如 1920 * 1080。无法识别时为空。'."\n", 'type' => 'string', 'example' => '2048 * 2048'],
                            'Name' => ['description' => '文件名。'."\n", 'type' => 'string', 'example' => 'photo.jpg'],
                            'Success' => ['description' => '请求是否成功。'."\n", 'type' => 'boolean'],
                            'Message' => ['description' => '附加信息。请求成功时返回 "success"。'."\n", 'type' => 'string', 'example' => 'success'],
                            'HttpStatusCode' => ['description' => 'HTTP 状态码。请求成功时返回 200。'."\n", 'type' => 'integer', 'format' => 'int32', 'example' => '200'],
                            'Code' => ['description' => '业务错误码。请求成功时返回 "OK"。'."\n", 'type' => 'string', 'example' => 'OK'],
                        ],
                        'description' => '',
                    ],
                ],
            ],
            'errorCodes' => [
                400 => [
                    ['errorCode' => 'IdempotentParameterMismatch', 'errorMessage' => '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.', 'description' => ''],
                ],
            ],
            'staticInfo' => ['returnType' => 'synchronous'],
            'title' => '检测图片基本信息',
            'summary' => '获取指定图片的文件名、格式、大小和分辨率等基本信息。',
            'description' => '## 请求说明'."\n"
                .'- 本接口用于检测并返回图片的基本信息，包括但不限于文件名、图片格式（如JPEG/PNG）、文件大小以及分辨率。'."\n"
                .'- 支持通过提供图片URL或OSS ObjectKey来指定待检测的图片。如果同时提供了ImageUrl和ObjectKey，则优先使用ObjectKey。'."\n"
                .'- 当使用ObjectKey时，请确保该对象属于当前调用者的命名空间内，不允许跨租户访问。'."\n"
                .'- 可选参数ClientToken用于保证请求的幂等性，建议每次请求都生成一个新的唯一值。'."\n",
            'changeSet' => [],
            'responseDemo' => '[{"errorExample":"","example":"{\\n  \\"Type\\": \\"PNG\\",\\n  \\"RequestId\\": \\"A1B2C3D4-E5F6-7890-ABCD-EF1234567890\\",\\n  \\"Size\\": \\"2.3 MB\\",\\n  \\"Dpi\\": \\"2048 * 2048\\",\\n  \\"Name\\": \\"photo.jpg\\",\\n  \\"Success\\": true,\\n  \\"Message\\": \\"success\\",\\n  \\"HttpStatusCode\\": 200,\\n  \\"Code\\": \\"OK\\"\\n}","type":"json"}]',
        ],
        'GetImageDetectionTaskResult' => [
            'path' => '',
            'methods' => ['get', 'post'],
            'schemes' => ['https'],
            'security' => [
                [
                    'AK' => [],
                ],
            ],
            'operationType' => 'read',
            'deprecated' => false,
            'systemTags' => [
                'operationType' => 'get',
                'riskType' => 'none',
                'chargeType' => 'free',
                'abilityTreeNodes' => ['FEATUREkms586TOR'],
                'tenantRelevance' => 'publicInformation',
            ],
            'parameters' => [
                [
                    'name' => 'ClientToken',
                    'in' => 'query',
                    'allowEmptyValue' => false,
                    'schema' => ['title' => '幂等参数', 'description' => '用于保证请求的幂等性。由客户端生成该参数值，要保证在不同请求间唯一。`ClientToken` 只支持 ASCII 字符，且不能超过 64 个字符。'."\n", 'type' => 'string', 'required' => false, 'example' => '5A2CFF0E-5718-45B5-9D4D-70B3FF3898'],
                ],
                [
                    'name' => 'TaskId',
                    'in' => 'query',
                    'schema' => ['description' => '任务 ID，由 `CreateImageDetectionTask` 返回。'."\n", 'type' => 'string', 'required' => true, 'example' => 'f47ac10b-58cc-4372-a567-0e02b2c3d479'],
                ],
            ],
            'responses' => [
                200 => [
                    'schema' => [
                        'title' => 'Schema of Response',
                        'description' => 'Schema of Response',
                        'type' => 'object',
                        'properties' => [
                            'RequestId' => ['title' => 'Id of the request', 'description' => '请求 ID。'."\n", 'type' => 'string', 'example' => 'A1B2C3D4-E5F6-7890-ABCD-EF1234567890'],
                            'TaskId' => ['description' => '任务 ID。'."\n", 'type' => 'string', 'example' => 'f47ac10b-58cc-4372-a567-0e02b2c3d479'],
                            'Success' => ['description' => '请求是否成功。'."\n", 'type' => 'boolean'],
                            'DetectMode' => ['description' => '实际执行的检测模式。取值：'."\n"
                                .'- aigc（仅 AIGC）'."\n"
                                .'- tamper（篡改检测）'."\n"
                                ."\n"
                                .'仅在 `Status` 为 `succeeded` 时返回。', 'type' => 'string', 'example' => 'tamper'],
                            'Labels' => [
                                'description' => 'AIGC 检测结果标签列表。仅在 `Status` 为 `succeeded` 且包含 AIGC 检测时返回。'."\n",
                                'type' => 'array',
                                'items' => [
                                    'type' => 'object',
                                    'properties' => [
                                        'Label' => ['description' => '检测标签。取值：'."\n"
                                            .'- ai_generated（AI 生成）'."\n"
                                            .'- non_ai_generated（非 AI 生成）'."\n", 'type' => 'string', 'example' => 'non_ai_generated'],
                                        'Confidence' => ['description' => '置信度，取值范围 0~1。'."\n", 'type' => 'number', 'format' => 'float', 'example' => '0.9562'],
                                    ],
                                    'description' => '',
                                ],
                            ],
                            'Message' => ['description' => '**附加信息**。请求成功时返回 `"success"`。任务失败时的错误信息。仅在 `Status` 为 `failed` 时返回。'."\n", 'type' => 'string', 'example' => 'success'],
                            'HttpStatusCode' => ['description' => '**HTTP 状态码**。请求成功时返回 `200`。'."\n", 'type' => 'integer', 'format' => 'int32', 'example' => '200'],
                            'Code' => ['description' => '**业务错误码**。请求成功时返回 `"OK"`。'."\n", 'type' => 'string', 'example' => 'OK'],
                            'Tamper' => [
                                'description' => '篡改检测结果。仅在 `DetectType` 为 `tamper` 或 `auto`（且识别为凭证类图片）时返回。'."\n",
                                'type' => 'object',
                                'properties' => [
                                    'RiskCode' => ['description' => '风险编码，`"0"` 表示无风险。'."\n", 'type' => 'string', 'example' => '0'],
                                    'RiskReasons' => [
                                        'description' => '风险原因列表。无风险时为空数组。'."\n",
                                        'type' => 'array',
                                        'items' => ['description' => '风险原因', 'type' => 'string', 'example' => '图片存在AI生成痕迹'],
                                    ],
                                    'BaseResults' => [
                                        'description' => '基础检测结果，包含多维度检测得分。'."\n",
                                        'type' => 'object',
                                        'properties' => [
                                            'Aigc' => [
                                                'description' => 'AIGC 检测得分。'."\n",
                                                'type' => 'object',
                                                'properties' => [
                                                    'Score' => ['description' => 'AIGC 检测得分，范围 0~1，值越高表示 AI 生成可能性越大。', 'type' => 'number', 'format' => 'float', 'example' => '0.47'],
                                                    'Desc' => ['description' => 'AIGC 检测结果描述。', 'type' => 'string', 'example' => '疑似AI生成图片'],
                                                ],
                                            ],
                                            'Aips' => [
                                                'description' => 'AI 后处理检测得分。'."\n",
                                                'type' => 'object',
                                                'properties' => [
                                                    'Score' => ['description' => 'AI 后处理检测得分，范围 0~1，值越高表示 AI 后处理可能性越大。'."\n", 'type' => 'number', 'format' => 'float', 'example' => '0.12'],
                                                    'Desc' => ['description' => 'AI 后处理检测结果描述。'."\n", 'type' => 'string', 'example' => '未发现AI后处理痕迹'],
                                                ],
                                            ],
                                            'PsLoc' => [
                                                'description' => 'PS 篡改定位结果。'."\n",
                                                'type' => 'object',
                                                'properties' => [
                                                    'Items' => [
                                                        'description' => '篡改区域列表。'."\n",
                                                        'type' => 'array',
                                                        'items' => [
                                                            'type' => 'object',
                                                            'properties' => [
                                                                'Bbox' => [
                                                                    'description' => '篡改区域边界框坐标，格式为 `[x1, y1, x2, y2]`。'."\n",
                                                                    'type' => 'array',
                                                                    'items' => ['description' => '篡改区域边界框坐标', 'type' => 'number', 'format' => 'float', 'example' => '[120.0, 80.0, 350.0, 260.0]'],
                                                                ],
                                                                'Score' => ['description' => '该区域的篡改置信度，范围 `0~1`。'."\n", 'type' => 'number', 'format' => 'float', 'example' => '0.67'],
                                                            ],
                                                            'description' => '',
                                                        ],
                                                    ],
                                                    'Desc' => ['description' => 'PS 篡改定位结果描述。'."\n", 'type' => 'string', 'example' => '发现1处疑似PS修改区域'],
                                                ],
                                            ],
                                            'ImgType' => ['description' => '图片类型。'."\n", 'type' => 'string', 'example' => 'natural'],
                                        ],
                                    ],
                                    'LlmResult' => ['description' => '大模型综合分析结果。'."\n", 'type' => 'string', 'example' => '该图片经检测存在AI生成痕迹，AIGC检测得分0.95，建议进一步核实图片来源。'],
                                ],
                            ],
                            'Status' => ['description' => '任务状态。取值：'."\n"
                                .'- `pending`（等待中）'."\n"
                                .'- `running`（执行中）'."\n"
                                .'- `succeeded`（已完成）'."\n"
                                .'- `failed`（失败）'."\n", 'type' => 'string', 'example' => 'succeeded'],
                        ],
                    ],
                ],
            ],
            'errorCodes' => [
                400 => [
                    ['errorCode' => 'IdempotentParameterMismatch', 'errorMessage' => '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.', 'description' => ''],
                ],
            ],
            'staticInfo' => ['returnType' => 'synchronous'],
            'title' => '查询图片检测任务结果',
            'summary' => '查询图片检测任务的状态和结果，包括AIGC检测标签和篡改检测结果。',
            'description' => '## 请求说明'."\n"
                .'调用本接口查询通过 `CreateImageDetectionTask` 创建的异步检测任务的执行状态和结果。建议以2~5秒的间隔轮询，直到任务状态变为 `succeeded` 或 `failed`。'."\n"
                ."\n"
                .'### 注意事项'."\n"
                .'- 请确保使用有效的 `TaskId` 进行查询。'."\n"
                .'- 如果任务尚未完成，请适当增加轮询间隔时间，避免频繁请求导致资源浪费。'."\n",
            'changeSet' => [],
            'responseDemo' => '[{"errorExample":"","example":"{\\n  \\"RequestId\\": \\"A1B2C3D4-E5F6-7890-ABCD-EF1234567890\\",\\n  \\"TaskId\\": \\"f47ac10b-58cc-4372-a567-0e02b2c3d479\\",\\n  \\"Success\\": true,\\n  \\"DetectMode\\": \\"tamper\\",\\n  \\"Labels\\": [\\n    {\\n      \\"Label\\": \\"non_ai_generated\\",\\n      \\"Confidence\\": 0.9562\\n    }\\n  ],\\n  \\"Message\\": \\"success\\",\\n  \\"HttpStatusCode\\": 200,\\n  \\"Code\\": \\"OK\\",\\n  \\"Tamper\\": {\\n    \\"RiskCode\\": \\"0\\",\\n    \\"RiskReasons\\": [\\n      \\"图片存在AI生成痕迹\\"\\n    ],\\n    \\"BaseResults\\": {\\n      \\"Aigc\\": {\\n        \\"Score\\": 0.47,\\n        \\"Desc\\": \\"疑似AI生成图片\\"\\n      },\\n      \\"Aips\\": {\\n        \\"Score\\": 0.12,\\n        \\"Desc\\": \\"未发现AI后处理痕迹\\"\\n      },\\n      \\"PsLoc\\": {\\n        \\"Items\\": [\\n          {\\n            \\"Bbox\\": [\\n              0\\n            ],\\n            \\"Score\\": 0.67\\n          }\\n        ],\\n        \\"Desc\\": \\"发现1处疑似PS修改区域\\"\\n      },\\n      \\"ImgType\\": \\"natural\\"\\n    },\\n    \\"LlmResult\\": \\"该图片经检测存在AI生成痕迹，AIGC检测得分0.95，建议进一步核实图片来源。\\"\\n  },\\n  \\"Status\\": \\"succeeded\\"\\n}","type":"json"}]',
        ],
        'GetImageTaskResult' => [
            'summary' => '查询异步图片生成任务的状态和结果，获取图片下载地址。',
            'methods' => ['get', 'post'],
            'schemes' => ['https'],
            'security' => [
                [
                    'AK' => [],
                ],
            ],
            'operationType' => 'read',
            'deprecated' => false,
            'systemTags' => [
                'operationType' => 'get',
                'riskType' => 'none',
                'chargeType' => 'free',
                'abilityTreeNodes' => ['FEATUREkms586TOR'],
                'tenantRelevance' => 'publicInformation',
            ],
            'parameters' => [
                [
                    'name' => 'TaskId',
                    'in' => 'query',
                    'schema' => ['title' => '任务ID', 'description' => '任务 ID，由 `CreateImageTask` 返回。'."\n", 'type' => 'string', 'required' => true, 'example' => 'f47ac10b-58cc-4372-a567-0e02b2c3d479'],
                ],
            ],
            'responses' => [
                200 => [
                    'schema' => [
                        'title' => 'Schema of Response',
                        'description' => 'Schema of Response',
                        'type' => 'object',
                        'properties' => [
                            'RequestId' => ['title' => 'Id of the request', 'description' => '请求 ID。'."\n", 'type' => 'string', 'example' => 'A1B2C3D4-E5F6-7890-ABCD-EF1234567890'],
                            'TaskId' => ['title' => '任务ID', 'description' => '任务 ID。'."\n", 'type' => 'string', 'example' => 'f47ac10b-58cc-4372-a567-0e02b2c3d479'],
                            'Status' => ['title' => '任务状态：pending/running/succeeded/failed', 'description' => '任务状态。取值：`pending`（等待中）、`running`（执行中）、`succeeded`（已完成）、`failed`（失败）。'."\n", 'type' => 'string', 'example' => 'succeeded'],
                            'ErrorMessage' => ['title' => '错误信息（仅failed状态）', 'description' => '错误信息（仅failed状态）', 'type' => 'string', 'example' => 'Instance access forbidden.'],
                            'Images' => [
                                'description' => '生成的图片列表。仅在 `Status` 为 `succeeded` 时返回。'."\n",
                                'type' => 'array',
                                'items' => [
                                    'type' => 'object',
                                    'properties' => [
                                        'Url' => ['description' => '图片预签名下载地址，有效期 1 小时。'."\n", 'type' => 'string', 'example' => 'https://bucket.oss-cn-hangzhou.aliyuncs.com/deepsign/123456789/image-generation/abc12345.png?Expires=1718700000&OSSAccessKeyId=...'],
                                        'ObjectKey' => ['description' => '图片在 OSS 中的 `ObjectKey`，可用于后续接口调用。'."\n", 'type' => 'string', 'example' => 'deepsign/123456789/image-generation/abc12345-def6-7890-abcd-ef1234567890.png'],
                                    ],
                                    'description' => '',
                                ],
                            ],
                            'Success' => ['description' => '请求是否成功。'."\n", 'type' => 'boolean', 'example' => 'true'],
                            'Message' => ['description' => '附加信息。请求成功时返回 `success`。任务失败时的错误信息。仅在 `Status` 为 `failed` 时返回。'."\n", 'type' => 'string', 'example' => 'success'],
                            'HttpStatusCode' => ['description' => 'HTTP 状态码。请求成功时返回 `200`。'."\n", 'type' => 'integer', 'format' => 'int32', 'example' => '200'],
                            'Code' => ['description' => '业务错误码。请求成功时返回 `OK`。'."\n", 'type' => 'string', 'example' => 'OK'],
                        ],
                    ],
                ],
            ],
            'errorCodes' => [
                400 => [
                    ['errorCode' => 'IdempotentParameterMismatch', 'errorMessage' => '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.', 'description' => ''],
                ],
            ],
            'staticInfo' => ['returnType' => 'synchronous'],
            'title' => '查询图片生成结果',
            'description' => '## 请求说明'."\n"
                .'- 调用本接口可以查询通过 `CreateImageTask` 创建的异步图片生成任务的执行状态和结果。'."\n"
                .'- 建议以 2~5 秒的间隔轮询，直到任务状态变为 `succeeded` 或 `failed`。'."\n"
                .'- 任务成功后返回的图片下载地址（Url）为预签名地址，有效期 1 小时。'."\n"
                .'- 为了保证请求的幂等性，可以通过设置 `ClientToken` 参数来实现。'."\n",
            'changeSet' => [],
            'responseDemo' => '[{"errorExample":"","example":"{\\n  \\"RequestId\\": \\"A1B2C3D4-E5F6-7890-ABCD-EF1234567890\\",\\n  \\"TaskId\\": \\"f47ac10b-58cc-4372-a567-0e02b2c3d479\\",\\n  \\"Status\\": \\"succeeded\\",\\n  \\"ErrorMessage\\": \\"Instance access forbidden.\\",\\n  \\"Images\\": [\\n    {\\n      \\"Url\\": \\"https://bucket.oss-cn-hangzhou.aliyuncs.com/deepsign/123456789/image-generation/abc12345.png?Expires=1718700000&OSSAccessKeyId=...\\",\\n      \\"ObjectKey\\": \\"deepsign/123456789/image-generation/abc12345-def6-7890-abcd-ef1234567890.png\\"\\n    }\\n  ],\\n  \\"Success\\": true,\\n  \\"Message\\": \\"success\\",\\n  \\"HttpStatusCode\\": 200,\\n  \\"Code\\": \\"OK\\"\\n}","type":"json"}]',
        ],
        'GetSensitiveScanResult' => [
            'summary' => '查询敏感信息扫描任务的状态和结果，返回扫描发现的敏感数据详情。',
            'methods' => ['get', 'post'],
            'schemes' => ['https'],
            'security' => [
                [
                    'AK' => [],
                ],
            ],
            'operationType' => 'read',
            'deprecated' => false,
            'systemTags' => [
                'operationType' => 'get',
                'riskType' => 'none',
                'chargeType' => 'free',
                'abilityTreeNodes' => ['FEATUREkms586TOR'],
                'tenantRelevance' => 'publicInformation',
            ],
            'parameters' => [
                [
                    'name' => 'TaskId',
                    'in' => 'query',
                    'schema' => ['title' => 'OSS文件路径', 'description' => '任务 ID，由 `CreateSensitiveScanTask` 返回。'."\n", 'type' => 'string', 'required' => true, 'example' => 'f47ac10b-58cc-4372-a567-0e02b2c3d479'],
                ],
            ],
            'responses' => [
                200 => [
                    'schema' => [
                        'title' => 'Schema of Response',
                        'description' => 'Schema of Response',
                        'type' => 'object',
                        'properties' => [
                            'RequestId' => ['title' => 'Id of the request', 'description' => '请求 ID。'."\n", 'type' => 'string', 'example' => 'A1B2C3D4-E5F6-7890-ABCD-EF1234567890'],
                            'Status' => ['title' => '任务状态：pending/running/paused/terminated/completed', 'description' => '任务状态。取值：`running`（执行中）、`completed`（已完成）、`terminated`（终止/失败）。'."\n", 'type' => 'string', 'example' => 'completed'],
                            'Result' => [
                                'title' => '扫描结果（仅completed状态返回）',
                                'description' => '扫描结果（仅completed状态返回）',
                                'type' => 'object',
                                'properties' => [
                                    'OssObjectDetail' => [
                                        'description' => '扫描对象名称。'."\n",
                                        'type' => 'object',
                                        'properties' => [
                                            'Name' => ['description' => '**扫描对象名称。**'."\n", 'type' => 'string', 'example' => 'abc12345.jpg'],
                                            'BucketName' => ['description' => '**所属 Bucket 名称。**'."\n", 'type' => 'string', 'example' => 'aideepsign-bucket'],
                                            'RiskLevelName' => ['description' => '**整体风险等级名称。**'."\n", 'type' => 'string', 'example' => 'S2'],
                                            'CategoryName' => ['description' => '**敏感数据分类名称。**'."\n", 'type' => 'string', 'example' => '个人信息'],
                                            'RuleList' => [
                                                'description' => '命中的敏感数据规则列表。'."\n",
                                                'type' => 'array',
                                                'items' => [
                                                    'type' => 'object',
                                                    'properties' => [
                                                        'CategoryName' => ['description' => '规则所属分类名称。'."\n", 'type' => 'string', 'example' => '个人信息'],
                                                        'RuleName' => ['description' => '规则名称。'."\n", 'type' => 'string', 'example' => '身份证号'],
                                                        'Count' => ['description' => '命中次数。'."\n", 'type' => 'integer', 'format' => 'int32', 'example' => '1'],
                                                        'RiskLevelName' => ['description' => '该规则的风险等级名称。'."\n", 'type' => 'string', 'example' => 'S2'],
                                                    ],
                                                    'description' => '',
                                                ],
                                            ],
                                        ],
                                    ],
                                ],
                            ],
                            'Success' => ['description' => '请求是否成功。'."\n", 'type' => 'boolean'],
                            'Message' => ['description' => '附加信息。请求成功时返回 "success"。'."\n", 'type' => 'string', 'example' => 'success'],
                            'HttpStatusCode' => ['description' => 'HTTP 状态码。请求成功时返回 200。'."\n", 'type' => 'integer', 'format' => 'int32', 'example' => '200'],
                            'Code' => ['description' => '业务错误码。请求成功时返回 "OK"。'."\n", 'type' => 'string', 'example' => 'OK'],
                        ],
                    ],
                ],
            ],
            'errorCodes' => [
                400 => [
                    ['errorCode' => 'IdempotentParameterMismatch', 'errorMessage' => '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.', 'description' => ''],
                ],
            ],
            'staticInfo' => ['returnType' => 'synchronous'],
            'title' => '查询敏感信息扫描结果',
            'description' => '## 请求说明'."\n"
                .'- 调用本接口查询通过 `CreateSensitiveScanTask` 创建的敏感信息扫描任务的执行状态和结果。'."\n"
                .'- 建议以 3~5 秒的间隔轮询，直到任务状态变为 `completed` 或 `terminated`。'."\n"
                .'- `ClientToken` 参数用于保证请求的幂等性，由客户端生成且在不同请求间唯一，支持 ASCII 字符，长度不超过 64 个字符。'."\n",
            'changeSet' => [],
            'responseDemo' => '[{"errorExample":"","example":"{\\n  \\"RequestId\\": \\"A1B2C3D4-E5F6-7890-ABCD-EF1234567890\\",\\n  \\"Status\\": \\"completed\\",\\n  \\"Result\\": {\\n    \\"OssObjectDetail\\": {\\n      \\"Name\\": \\"abc12345.jpg\\",\\n      \\"BucketName\\": \\"aideepsign-bucket\\",\\n      \\"RiskLevelName\\": \\"S2\\",\\n      \\"CategoryName\\": \\"个人信息\\",\\n      \\"RuleList\\": [\\n        {\\n          \\"CategoryName\\": \\"个人信息\\",\\n          \\"RuleName\\": \\"身份证号\\",\\n          \\"Count\\": 1,\\n          \\"RiskLevelName\\": \\"S2\\"\\n        }\\n      ]\\n    }\\n  },\\n  \\"Success\\": true,\\n  \\"Message\\": \\"success\\",\\n  \\"HttpStatusCode\\": 200,\\n  \\"Code\\": \\"OK\\"\\n}","type":"json"}]',
        ],
        'SignUserImage' => [
            'summary' => '对用户上传的图片嵌入C2PA数字签名并返回下载地址。',
            'methods' => ['post'],
            'schemes' => ['https'],
            'security' => [
                [
                    'AK' => [],
                ],
            ],
            'operationType' => 'readAndWrite',
            'deprecated' => false,
            'systemTags' => [
                'operationType' => 'update',
                'riskType' => 'none',
                'chargeType' => 'free',
                'abilityTreeNodes' => ['FEATUREkms586TOR'],
                'autoTest' => true,
                'tenantRelevance' => 'publicInformation',
            ],
            'parameters' => [
                [
                    'name' => 'ClientToken',
                    'in' => 'query',
                    'allowEmptyValue' => false,
                    'schema' => ['title' => '幂等参数', 'description' => '用于保证请求的幂等性。由客户端生成该参数值，要保证在不同请求间唯一。ClientToken 只支持 ASCII 字符，且不能超过 64 个字符。'."\n", 'type' => 'string', 'required' => false, 'example' => '5A2CFF0E-5718-45B5-9D4D-70B3FF3898'],
                ],
                [
                    'name' => 'ImageUrl',
                    'in' => 'query',
                    'schema' => ['description' => '待签名图片的 URL 地址。支持 HTTP/HTTPS 链接。`ImageUrl` 与 `ObjectKey` 二选一，至少提供一个。', 'type' => 'string', 'required' => false, 'example' => 'https://example.com/photo.jpg'],
                ],
                [
                    'name' => 'ObjectKey',
                    'in' => 'query',
                    'schema' => ['description' => '待签名图片在 OSS 中的 `ObjectKey`。使用 `ObjectKey` 时需确保该 Key 属于当前调用者的命名空间。`ImageUrl` 与 `ObjectKey` 二选一，至少提供一个。'."\n", 'type' => 'string', 'required' => false, 'example' => 'deepsign/123456789/image-generation/abc12345-def6-7890-abcd-ef1234567890.png'],
                ],
            ],
            'responses' => [
                200 => [
                    'schema' => [
                        'type' => 'object',
                        'properties' => [
                            'SignTime' => ['description' => '签名时间（ISO 8601 格式），如 `2026-01-15T08:30:00Z`。'."\n", 'type' => 'string', 'example' => '2026-06-18T10:30:00Z'],
                            'RequestId' => ['description' => '请求 ID。'."\n", 'type' => 'string', 'example' => 'A1B2C3D4-E5F6-7890-ABCD-EF1234567890'],
                            'SignedImageUrl' => ['description' => '已签名图片的预签名下载地址。'."\n", 'type' => 'string', 'example' => 'https://bucket.oss-cn-hangzhou.aliyuncs.com/deepsign/123456789/signed/abc12345.png?Expires=1718700000&OSSAccessKeyId=...'],
                            'CertificateSubject' => ['description' => '签名证书的主题（Subject）信息。'."\n", 'type' => 'string', 'example' => 'CN=AIDeepSign User Certificate,O=Alibaba Cloud'],
                            'ObjectKey' => ['description' => '已签名图片在 OSS 中的 ObjectKey，可用于后续接口调用。'."\n", 'type' => 'string', 'example' => 'deepsign/123456789/signed/abc12345-def6-7890-abcd-ef1234567890.png'],
                            'Algorithm' => ['description' => '签名使用的算法，如 ps256、es256 等。'."\n", 'type' => 'string', 'example' => 'ps256'],
                            'Success' => ['description' => '请求是否成功。'."\n", 'type' => 'boolean'],
                            'Message' => ['description' => '附加信息。请求成功时返回 "success"。'."\n", 'type' => 'string', 'example' => 'success'],
                            'HttpStatusCode' => ['description' => 'HTTP 状态码。请求成功时返回 200。'."\n", 'type' => 'integer', 'format' => 'int32', 'example' => '200'],
                            'Code' => ['description' => '业务错误码。请求成功时返回 "OK"。'."\n", 'type' => 'string', 'example' => 'OK'],
                        ],
                        'description' => '',
                    ],
                ],
            ],
            'errorCodes' => [
                400 => [
                    ['errorCode' => 'IdempotentParameterMismatch', 'errorMessage' => '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.', 'description' => ''],
                ],
            ],
            'staticInfo' => ['returnType' => 'synchronous'],
            'title' => '图片签名',
            'description' => '## 请求说明'."\n"
                .'- `ImageUrl` 和 `ObjectKey` 必须至少提供一个，如果两个都提供，则优先使用 `ObjectKey`。'."\n"
                .'- 使用 `ObjectKey` 方式时，系统会校验该 `ObjectKey` 是否属于当前调用者，不允许跨租户访问。'."\n"
                .'- 支持的图片格式为 JPEG 和 PNG，不支持的格式将返回 `C2PA_FORMAT_UNSUPPORTED` 错误。'."\n"
                .'- 如果原图已包含 C2PA 签名，系统会保留原始签名作为成分，并在此基础上追加新签名。'."\n"
                .'- 可通过 `ClientToken` 参数保证请求的幂等性，但需确保其在不同请求间唯一且不超过64个字符。'."\n",
            'changeSet' => [],
            'responseDemo' => '[{"errorExample":"","example":"{\\n  \\"SignTime\\": \\"2026-06-18T10:30:00Z\\",\\n  \\"RequestId\\": \\"A1B2C3D4-E5F6-7890-ABCD-EF1234567890\\",\\n  \\"SignedImageUrl\\": \\"https://bucket.oss-cn-hangzhou.aliyuncs.com/deepsign/123456789/signed/abc12345.png?Expires=1718700000&OSSAccessKeyId=...\\",\\n  \\"CertificateSubject\\": \\"CN=AIDeepSign User Certificate,O=Alibaba Cloud\\",\\n  \\"ObjectKey\\": \\"deepsign/123456789/signed/abc12345-def6-7890-abcd-ef1234567890.png\\",\\n  \\"Algorithm\\": \\"ps256\\",\\n  \\"Success\\": true,\\n  \\"Message\\": \\"success\\",\\n  \\"HttpStatusCode\\": 200,\\n  \\"Code\\": \\"OK\\"\\n}","type":"json"}]',
        ],
        'VerifyImageSignature' => [
            'methods' => ['post'],
            'schemes' => ['https'],
            'security' => [
                [
                    'AK' => [],
                ],
            ],
            'operationType' => 'read',
            'deprecated' => false,
            'systemTags' => [
                'operationType' => 'get',
                'riskType' => 'none',
                'chargeType' => 'free',
                'abilityTreeNodes' => ['FEATUREkms586TOR'],
                'autoTest' => true,
                'tenantRelevance' => 'publicInformation',
            ],
            'parameters' => [
                [
                    'name' => 'ImageUrl',
                    'in' => 'query',
                    'schema' => ['description' => '待验证图片的 URL 地址。`ImageUrl` 与 `ObjectKey` 二选一，至少提供一个。'."\n", 'type' => 'string', 'required' => false, 'example' => 'https://example.com/signed-photo.jpg'],
                ],
                [
                    'name' => 'ObjectKey',
                    'in' => 'query',
                    'schema' => ['description' => '待验证图片在 OSS 中的 `ObjectKey`。使用 `ObjectKey` 时需确保该 Key 属于当前调用者的命名空间。`ImageUrl` 与 `ObjectKey` 二选一，至少提供一个。'."\n", 'type' => 'string', 'required' => false, 'example' => 'deepsign/123456789/image-generation/abc12345-def6-7890-abcd-ef1234567890.png'],
                ],
            ],
            'responses' => [
                200 => [
                    'schema' => [
                        'type' => 'object',
                        'properties' => [
                            'Message' => ['description' => '附加信息。请求成功时返回 `success`。'."\n", 'type' => 'string', 'example' => 'success'],
                            'RequestId' => ['description' => '请求 ID。'."\n", 'type' => 'string', 'example' => 'A1B2C3D4-E5F6-7890-ABCD-EF1234567890'],
                            'Issuer' => [
                                'description' => '签发者信息。'."\n",
                                'type' => 'object',
                                'properties' => [
                                    'CommonName' => ['description' => '签发者通用名称（CN）。'."\n", 'type' => 'string', 'example' => 'AIDeepSign User Certificate'],
                                    'Organization' => ['description' => '签发者组织名称（O）。'."\n", 'type' => 'string', 'example' => 'Alibaba Cloud'],
                                ],
                            ],
                            'HttpStatusCode' => ['description' => 'HTTP 状态码。请求成功时返回 `200`。'."\n", 'type' => 'integer', 'format' => 'int64', 'example' => '200'],
                            'VerificationState' => ['description' => '签名验证状态。取值：Valid（签名有效）、Invalid（签名无效或已被篡改）、Trusted(签名有效且被信任）。', 'type' => 'string', 'example' => 'Valid'],
                            'IssuerTrusted' => ['description' => '签发者是否可信。true 表示签发者证书由受信任的 CA 签发。'."\n", 'type' => 'boolean'],
                            'Manifest' => [
                                'description' => '内容凭证清单信息。仅在图片包含 C2PA 签名时返回。'."\n",
                                'type' => 'object',
                                'properties' => [
                                    'Assertions' => [
                                        'description' => '断言信息列表，包含图片的来源和编辑历史等元数据。'."\n",
                                        'type' => 'array',
                                        'items' => [
                                            'type' => 'object',
                                            'properties' => [
                                                'Data' => ['description' => '断言数据，JSON 格式的详细元数据。'."\n", 'type' => 'string', 'example' => '{"actions":[{"action":"c2pa.created"}]}'],
                                                'Label' => ['description' => '断言标签，如 c2pa.actions、stds.exif 等。'."\n", 'type' => 'string', 'example' => 'c2pa.actions'],
                                            ],
                                            'description' => '',
                                        ],
                                    ],
                                    'SignatureInfo' => [
                                        'description' => '签名详细信息。'."\n",
                                        'type' => 'object',
                                        'properties' => [
                                            'Alg' => ['description' => '签名算法，如 `ps256`、`es256` 等。'."\n", 'type' => 'string', 'example' => 'ps256'],
                                            'Issuer' => ['description' => '签名证书的签发者 DN。'."\n", 'type' => 'string', 'example' => 'CN=AIDeepSign CA,O=Alibaba Cloud'],
                                            'Time' => ['description' => '签名时间（ISO 8601 格式）。'."\n", 'type' => 'string', 'example' => '2026-06-18T10:30:00Z'],
                                        ],
                                    ],
                                ],
                            ],
                            'Success' => ['description' => '请求是否成功。'."\n", 'type' => 'boolean'],
                            'Code' => ['description' => '业务错误码。请求成功时返回 "OK"。'."\n", 'type' => 'string', 'example' => 'OK'],
                        ],
                        'description' => '',
                    ],
                ],
            ],
            'errorCodes' => [
                400 => [
                    ['errorCode' => 'IdempotentParameterMismatch', 'errorMessage' => '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.', 'description' => ''],
                ],
            ],
            'staticInfo' => ['returnType' => 'synchronous'],
            'title' => '验证图片签名',
            'summary' => '验证图片中的C2PA数字签名，返回签名状态及签发者信息。',
            'description' => '## 请求说明'."\n"
                .'- 本接口用于验证图片中嵌入的 C2PA 数字签名，并返回签名验证状态、签发者可信度、签发者信息以及完整的内容凭证清单（Manifest）。'."\n"
                .'- 支持通过图片 URL 或 OSS ObjectKey 指定待验证图片。如果同时提供 ImageUrl 和 ObjectKey，则优先使用 ObjectKey。'."\n"
                .'- 使用 ObjectKey 方式时，系统会校验该 ObjectKey 是否属于当前调用者，不允许跨租户访问。'."\n"
                .'- 为了保证请求的幂等性，可以提供 ClientToken 参数，但需确保其在不同请求间唯一且不超过 64 个字符。'."\n",
            'changeSet' => [],
            'responseDemo' => '[{"errorExample":"","example":"{\\n  \\"Message\\": \\"success\\",\\n  \\"RequestId\\": \\"A1B2C3D4-E5F6-7890-ABCD-EF1234567890\\",\\n  \\"Issuer\\": {\\n    \\"CommonName\\": \\"AIDeepSign User Certificate\\",\\n    \\"Organization\\": \\"Alibaba Cloud\\"\\n  },\\n  \\"HttpStatusCode\\": 200,\\n  \\"VerificationState\\": \\"Valid\\",\\n  \\"IssuerTrusted\\": true,\\n  \\"Manifest\\": {\\n    \\"Assertions\\": [\\n      {\\n        \\"Data\\": \\"{\\\\\\"actions\\\\\\":[{\\\\\\"action\\\\\\":\\\\\\"c2pa.created\\\\\\"}]}\\",\\n        \\"Label\\": \\"c2pa.actions\\"\\n      }\\n    ],\\n    \\"SignatureInfo\\": {\\n      \\"Alg\\": \\"ps256\\",\\n      \\"Issuer\\": \\"CN=AIDeepSign CA,O=Alibaba Cloud\\",\\n      \\"Time\\": \\"2026-06-18T10:30:00Z\\"\\n    }\\n  },\\n  \\"Success\\": true,\\n  \\"Code\\": \\"OK\\"\\n}","type":"json"}]',
        ],
    ],
    'endpoints' => [
        ['regionId' => 'cn-hangzhou', 'regionName' => '华东1（杭州）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'aideepsign.cn-hangzhou.aliyuncs.com', 'endpoint' => 'aideepsign.cn-hangzhou.aliyuncs.com', 'vpc' => 'aideepsign-vpc.cn-hangzhou.aliyuncs.com'],
    ],
    'errorCodes' => [
        ['code' => 'Throttling', 'message' => 'user xxx does not hold a valid subscription.', 'http_code' => 429, 'description' => '用户无有效订阅'],
    ],
    'changeSet' => [],
];