返回码

简介

HI,您好,欢迎使用腾讯AI开放平台HTTP API接口服务。

本文档主要针对需要集成HTTP API的技术研发工程师,详细描述API响应返回码与异常处理机制的相关技术内容。

如果您对文档内容有任何疑问,可以通过以下几种方式联系我们:

官方交流一群:581197347

官方交流二群:705874401

官方交流三群:415349651

联系邮箱:aicamp@tencent.com

异常处理机制

HTTP API无法正常处理接口请求时,会在响应结果中返回相应的返回码,告知调用者出错原因。

接口返回码用途分布如下,请调用者关注。

数值范围 返回码用途
小于0 表示系统出错,例如网络超时;一般情况下需要发出告警,共同定位问题原因。
等于0 表示处理成功
大于0 表示业务出错,例如调用者传递非法参数;不同业务错误有单独的返回码定义。

返回码定义

一般情况下,接口调用出错时,只会返回业务出错。

对于返回小于0的系统出错,请调用者一致认为是系统异常,发出告警并进行问题定位。

对于返回大于0的业务出错,请调用者详细了解每个返回码的含义及建议处理方式。

返回码定义 返回码描述 建议处理方式
9 qps超过限制 用户认证升级或者降低调用频率
4096 参数非法 请检查请求参数是否符合要求
12289 应用不存在 请检查app_id是否有效的应用标识(AppId)
12801 素材不存在 请检查app_id对应的素材模版id
12802 素材ID与应用ID不匹配 请检查app_id对应的素材模版id
16385 缺少app_id参数 请检查请求中是否包含有效的app_id参数
16386 缺少time_stamp参数 请检查请求中是否包含有效的time_stamp参数
16387 缺少nonce_str参数 请检查请求中是否包含有效的nonce_str参数
16388 请求签名无效 请检查请求中的签名信息(sign)是否有效
16389 缺失API权限 请检查应用是否勾选当前API所属接口的权限
16390 time_stamp参数无效 请检查time_stamp距离当前时间是否超过5分钟
16391 同义词识别结果为空 请尝试更换文案
16392 专有名词识别结果为空 请尝试更换文案
16393 意图识别结果为空 请尝试更换文案
16394 闲聊返回结果为空 请联系客服反馈问题
16396 图片格式非法 请检查图片格式是否符合API要求
16397 图片体积过大 请检查图片大小是否超过API限制
16402 图片没有人脸 请检查图片是否包含人脸
16403 相似度错误 请联系客服反馈问题
16404 人脸检测失败 请联系客服反馈问题
16405 图片解码失败 请联系客服反馈问题
16406 特征处理失败 请联系客服反馈问题
16407 提取轮廓错误 请联系客服反馈问题
16408 提取性别错误 请联系客服反馈问题
16409 提取表情错误 请联系客服反馈问题
16410 提取年龄错误 请联系客服反馈问题
16411 提取姿态错误 请联系客服反馈问题
16412 提取眼镜错误 请联系客服反馈问题
16413 提取魅力值错误 请联系客服反馈问题
16414 语音合成失败 请联系客服反馈问题
16415 图片为空 请检查图片是否正常
16416 个体已存在 请检查个体是否已存在
16417 个体不存在 请检查个体是否不存在
16418 人脸不存在 请检查人脸是否不存在
16419 分组不存在 请检查分组是否不存在
16420 分组列表不存在 请检查分组列表是否不存在
16421 人脸个数超过限制 请检查是否超过系统限制
16422 个体个数超过限制 请检查是否超过系统限制
16423 组个数超过限制 请检查是否超过系统限制
16424 对个体添加了几乎相同的人脸 请检查个体已添加的人脸
16425 无效的图片格式 请检查图片格式是否符号API要求
16426 图片模糊度检测失败 请联系客服反馈问题
16427 美食图片检测失败 请联系客服反馈问题
16428 提取图像指纹失败 请联系客服反馈问题
16429 图像特征比对失败 请联系客服反馈问题
16430 OCR照片为空 请检查待处理图片是否为空
16431 OCR识别失败 请尝试更换带有文字的图片
16432 输入图片不是身份证 请检查图片是否为身份证
16433 名片无足够文本 请检查名片是否正常
16434 名片文本行倾斜角度太大 请检查名片是否正常
16435 名片模糊 请检查名片是否正常
16436 名片姓名识别失败 请尝试更换姓名显示清晰的名片图片
16437 名片电话识别失败 请尝试更换电话显示清晰的名片图片
16438 图像为非名片图像 请尝试更换有效的名片图片
16439 检测或者识别失败 请联系客服反馈问题
16440 未检测到身份证 请对准边框(避免拍摄时倾角和旋转角过大、摄像头)
16441 请使用第二代身份证件进行扫描 请使用第二代身份证进行处理
16442 不是身份证正面照片 请使用带证件照的一面进行处理
16443 不是身份证反面照片 请使用身份证反面进行进行处理
16444 证件图片模糊 请确保证件图片清晰
16445 请避开灯光直射在证件表面 请避开灯光直射在证件表面
16446 行驾驶证OCR识别失败 请尝试更换有效的行驾驶证图片
16447 通用OCR识别失败 请尝试更换带有文字的图片
16448 银行卡OCR预处理错误 请联系客服反馈问题
16449 银行卡OCR识别失败 请尝试更换有效的银行卡图片
16450 营业执照OCR预处理失败 请联系客服反馈问题
16451 营业执照OCR识别失败 请联系客服反馈问题
16452 意图识别超时 请联系客服反馈问题
16453 闲聊处理超时 请联系客服反馈问题
16454 语音识别解码失败 请检查语音参数是否正确编码
16455 语音过长或空 请检查语音参数是否正确编码或者长度是否合法
16456 翻译引擎失败 请联系客服反馈问题
16457 不支持的翻译类型 请检查翻译类型参数是否合法
16460 输入图片与识别场景不匹配 请检查场景参数是否正确,所传图片与场景是否匹配
16461 识别结果为空 当前图片无法匹配已收录的标签,请尝试更换图片
16462 多人脸检测识别结果为空 图片中识别不出人脸,请尝试更换图片
16467 跨年龄人脸识别出错 请尝试更换有人脸的图片
16468 跨年龄人脸识别结果为空 源图片与目标图片中识别不出匹配的人脸,请尝试更换图片
16472 音频鉴黄识别出错 请确保音频地址能正常下载音频,尝试更换音频

随着接口能力不断升级,新的返回码会逐步开放,请留意本文档的更新通知

AI开放平台公众号
关注公众号

打造升级AI项目
推送全球AI热点