8005400006(身份证鉴伪-V1.1.0)

接口信息

API Path
/aipaas/lm/v1/idcard/fakeDetection

请求协议
HTTPS

请求方法
POST

请求头部 ：

头部标签	必填	说明	类型	数据字典	限制	头部内容	示例
Content-Type	是	内容类型				application/json	application/json
X-APP-ID	是	买家中心-已购能力-【X-APP-ID】
Device-Uuid	是	设备管理-设备uuid
Authorization	是	鉴权信息

请求参数 Json
Object

参数名	说明	必填	类型	数据字典	限制	示例
seq_id	请求序列号，请求的唯一标识，不能为空字符	是	[string]		0
image	string[]，图片base64，建议编码后大小不超过10M，最短边至少15px，图片分辨率不超过3840*3840（算法服务内部未做强校验），当前只支持传一个	是	[array]		0

响应内容 ：

返回结果

成功 (200)
Json
Object

参数名	说明	必填	类型	数据字典	限制	示例
seq_id	请求序列号，usid，请求的唯一标识，透传	是	[string]		0
task_id	算法id，全区身份证鉴伪固定为50009	是	[int]		0
send_pts_ms	返回消息时间戳	是	[long]		0
code	状态响应码。参考状态码说明	是	[string]		0
message	调用结果描述。参考错误编码规范	是	[string]		0
flag	业务成功或失败：1成功，0失败	是	[int]		0
data		是	[object]		0
data>>status	0：未开始 1：执行中 2：执行成功 3：执行失败	是	[int]		0
data>>task_result		是	[object]		0
data>>task_result>>out_text	鉴伪结果。border_complete：判断是否边框完整，bool类型，True代表完整。 is_screen：判断是否屏幕翻拍，bool类型，True代表是翻拍，score为模型预测得分，float类型。 is_print：判断是否为打印件，bool类型，True代表是打印件，score为模型预测得分，float类型。 is_blurry：判断证件是否模糊，bool类型，True代表模糊，score为模型预测得分，float类型。 reflection_detected：判断证件是否反光，bool类型，True代表证件反光，score为模型预测得分，float类型。 is_ps：判断证件是否为PS篡改，bool类型，True代表存在PS篡改，score为模型预测得分，float类型。 cover：判断证件是否为遮挡，bool类型，True代表存在遮挡。	是	[array]		0

成功示例

{

    "seq_id": "test_image",

    "send_pts_ms": 1761802902,

    "code": "10000",

    "message": "ok",

    "flag": 1,

    "data": {

        "status": 2,

        "task_result": {

            "out_text": [{

                "border_complete": {

                    "border_complete": false

                },

                "reflection": {

                    "reflection_detected": false,

                    "score": 0

                },

                "photoshop": {

                    "is_ps": true,

                    "score": 0.9999998807907104

                },

                "printout": {

                    "is_print": false,

                    "score": 0.12185389568839021

                },

                "screen": {

                    "is_screen": false,

                    "score": 0.000027179718017578125

                },

                "blur": {

                    "is_blurry": false,

                    "score": 0.00007975101470947266

                }

            }]

        }

    }

}

1、能力简介

助力业务打击虚假实名，提升效率优化体验，打造身份证鉴伪能力，支持身份证图片模糊检测、反光检测、复印件检测、屏幕翻拍检测、篡改检测；

2、修订历史

| 修订日期 | 算法版本号 | 修订内容 |

| ---- | ----- | ---- |

| 2025-12-22 | V1.1.0 | 更新身份证检测模型，增加边框不完整识别、彩印识别、遮挡识别，优化篡改、翻拍检测能力；
调整文档结构； 回复字段out_text新增字段cover |

| 2025-11-19 | V1.0.0 | 初始化API文档 |

3、服务鉴权

服务接口调用时需要严格遵循服务鉴权规则，服务调用鉴权规则请参见：开发指南 - 接口签名认证。

4、请求参数说明

• 无

5、响应结果说明

• 无

6、请求示例

{

    "seq_id": "test_image",

    "image": [

        "yourImage"

    ]

}

7、状态码说明

| 状态码 | 返回信息 | 说明 |

|--------|----------|------|

| 10000 | 服务执行成功 | 正确执行并返回结果 |

| 10304 | 请求参数格式或类型错误 | 服务入参格式错误，必填参数缺失或未填写 |

| 10503 | 服务连接超时 | 连接第三方服务发生超时，返回服务连接超时错误 |

| 10903 | 服务执行失败 | 服务执行失败 |

说明：

• 输入图片检测到两张以上身份证时，服务返回状态码10304，message中包含关键字段“found more than one card”；
• 输入图片未检测到身份证时，服务返回状态码10000，out_text中结果为空；
• 输入图片正常检测到身份证时，服务返回状态码10000，out_text中包含鉴伪的六项指标。

---