Skip to main content

​
AI发型设计 - 响应说明

​
公共响应字段

字段必填类型范围描述
request_id是string请求ID。
  • 如果出现问题无法定位，可以将此字段发送给技术支持进行问题定位。
    • log_id是string日志ID。
  • 如果出现问题无法定位，可以将此字段发送给技术支持进行问题定位。
    • error_code是integer状态码。
  • 当HTTP状态为200时：error_code=0；否则与HTTP状态完全相同。
    • error_detail是object错误详情。
    +status_code是integer状态码。
    +code是string查看错误代码。
    +code_message是string错误代码(code)表示的信息。
    +message是stringcode_message字段的补充信息。

    ​
    如何验证请求是否成功？

    • 使用HTTP状态码：
      • 200: 成功。
      • 其他: 失败。
    • 使用error_code字段：
      • 0: 成功。
      • 其他: 失败。

    成功响应示例

    {
  "request_id":   "请求ID",
  "log_id":       "日志ID",
  "error_code":   0,
  "error_detail": {
    "status_code":  200,
    "code":         "",
    "code_message": "",
    "message":      ""
  }
}

    失败响应示例

    {
  "request_id":   "请求ID",
  "log_id":       "日志ID",
  "error_code":   422,
  "error_detail": {
    "status_code":  422,
    "code":         "ERROR_NO_FACE_IN_FILE",
    "code_message": "文件中未检测到人脸。",
    "message":      "图片中没有人脸"
  }
}

    ​
    error_detail.code 解析

    HTTP状态错误代码描述
    400PROCESSING_FAILURE处理失败。
    400ERROR_PARAMETERS无效参数。
    400MISSING_PARAMETERS缺少参数。
    400ERROR_INVALID_PARAMETER无效参数。
    400PARAMETERS_CANNOT_EMPTY参数不能为空。
    400ERROR_MISSING_LIMIT_PARAMETER缺少Limit参数。
    400ERROR_MISSING_TASKS_PARAMETER缺少Tasks参数。
    400ERROR_MISSING_ASSURE_DIRECTION_PARAMETER缺少AssureDirection参数。
    400ERROR_MISSING_MIN_HEIGHT_PARAMETER缺少MinHeight参数。
    400ERROR_INVALID_SIDE_PARAMETERSide参数值无效。
    400ERROR_TOO_MANY_FILES文件数量超出限制。
    400ERROR_FACE_TRACE_LIMIT_EXCEEDED人脸或追踪限制超出。
    400ERROR_INVALID_URL无效的URL。
    400ERROR_DATABASE_LIMIT_EXCEEDED数据库限制超出。
    400ERROR_INVALID_RESPONSE_FORMAT响应格式错误（不支持的Accept）。
    400ERROR_UNSUPPORTED_RESPONSE_FORMAT响应格式错误（不支持的格式）。
    400ERROR_TOO_MANY_GROUPS_IN_GROUP_LISTgroup_list中组数过多。
    400ERROR_TOO_MANY_UIDS_IN_UID_LISTuid_list中UID数量过多。
    400ERROR_TOO_MANY_APPS_IN_APP_LISTapp_list中应用数量过多。
    400ERROR_BATCH_TASK_LIMIT_EXCEEDED批量任务处理限制超出。
    400ERROR_CLEANING_USER_GROUP_DATA正在清理用户组数据。
    400ERROR_IMAGE_STORAGE_NOT_SUPPORTED不支持图片存储。
    400ERROR_INSUFFICIENT_RESOURCES资源不足。
    400ERROR_RESOURCE_IN_TRANSIT资源传输中。
    400ERROR_FILE_DOWNLOAD_FAILED文件下载失败。
    400ERROR_FILE_UPLOAD_FAILED文件上传失败。
    400FILE_DECODING_FAILURE文件解码失败。
    400ERROR_FACE_BLENDING_FAILED人脸融合失败。
    400ERROR_FACE_IMAGE_ADDITION_FAILED添加人脸图像失败。
    400ERROR_GET_FACE_IMAGE_FAILED获取人脸图像失败。
    400ERROR_DATA_TRANSFER_FAILED数据传输（下载或上传）失败。
    400ERROR_TASK_REVOCATION_FAILED任务撤销失败。
    400ERROR_RESOURCE_UNAVAILABLE资源暂时不可用。
    400ERROR_FILE_DOWNLOAD_TIMEOUT文件下载超时。
    401ERROR_USER_NOT_EXISTS用户不存在。
    401ERROR_APPLICATIONS_NOT_EXISTS应用程序不存在。
    403ERROR_USER_LOCKED用户已被锁定。
    403AI_SERVICE_UNAUTHORIZEDAI服务未授权。请稍后重试，如未及时解决请联系平台。
    403ERROR_ILLEGAL_FILE非法文件。
    404ERROR_AI_NOT_EXISTSAI不存在或已被停用，请联系平台。
    404AI_SERVICE_NOT_FOUND找不到AI服务。请稍后重试，如未及时解决请联系平台。
    404ERROR_FILE_NOT_FOUND找不到文件。
    404ERROR_FACE_NOT_FOUND找不到人脸。
    404ERROR_USER_GROUP_NOT_FOUND找不到用户组。
    404ERROR_USER_NOT_FOUND找不到用户。
    404ERROR_FACE_TOKEN_NOT_FOUND找不到人脸令牌。
    404ERROR_CONTENT_NOT_FOUND找不到内容。
    404ERROR_RESOURCE_NOT_FOUND找不到资源。
    405ERROR_ILLEGAL_OPERATION非法操作。
    409ERROR_FACE_ALREADY_EXISTS人脸已存在。
    409ERROR_DATA_ALREADY_EXISTS数据已存在。
    409ERROR_USER_GROUP_ALREADY_EXISTS用户组已存在。
    409ERROR_USER_ALREADY_EXISTS用户已存在。
    409ERROR_DUPLICATE_GROUP_NAME重复的组名。
    409ERROR_RESOURCE_IN_USE资源正在使用中。
    409ERROR_TASK_CONFLICT任务冲突。
    409ERROR_TASK_REVOKED任务已被撤销。
    410ERROR_RESOURCE_RECLAIMED资源已被回收。
    413FILE_SIZE_EXCEEDS_LIMIT文件大小超出限制。
    413ERROR_CONTENT_TOO_LONG内容长度超出限制。
    413ERROR_VIDEO_DURATION_EXCEEDED视频时长超出限制。
    413ERROR_REQUEST_BODY_TOO_LARGE请求体大小超出限制。
    413ERROR_RESPONSE_BODY_TOO_LARGE响应体大小超出限制。
    415UNSUPPORTED_FILE_TYPES不支持的文件类型。
    415ERROR_INVALID_OUTPUT_FORMAT无效的输出格式。
    415ERROR_UNSUPPORTED_GRAYSCALE_IMAGE不支持灰度图像。
    422UNSUPPORTED_PARAMETER_VALUES不支持的参数值。
    422ERROR_INVALID_FACE_BOX_PARAMETER人脸框参数不符合要求。
    422ERROR_INVALID_BIG_EYES_PARAMETER大眼参数不符合要求。
    422ERROR_INVALID_FACE_SLIMMING_PARAMETER瘦脸参数不符合要求。
    422ERROR_INVALID_SMOOTHING_PARAMETER光滑参数不符合要求。
    422ERROR_INVALID_SKIN_WHITENING_PARAMETER美白参数不符合要求。
    422ERROR_INVALID_PARAMETER_FORMAT无效的参数格式。
    422ERROR_PARAMETER_CONVERSION_FAILED参数转换失败。
    422FILE_RESOLUTION_EXCEEDS_LIMITS文件分辨率超出限制。
    422ERROR_LOW_RESOLUTION文件分辨率过低。
    422ERROR_HIGH_RESOLUTION文件分辨率过高。
    422ERROR_INVALID_FILE无效文件。
    422FILE_CONTENT_NON_COMPLIANCE文件内容不符合要求。
    422ERROR_INCORRECT_FILE_COUNT文件数量不正确。
    422ERROR_NO_FACE_IN_FILE文件中未检测到人脸。
    422ERROR_FACE_SIZE_NOT_MEET_REQUIREMENTS人脸大小不符合要求。
    422ERROR_FACE_SIZE_RATIO_NOT_MET人脸大小比例不符合要求。
    422ERROR_SMALL_FACE_SIZE人脸太小。
    422ERROR_FACE_COPY_SCENE_MISMATCH人脸复制场景类型不匹配。
    422ERROR_FACE_UNRECOGNIZABLE无法识别人脸。
    422ERROR_POOR_FACE_QUALITY人脸质量差。
    422ERROR_BLURRY_FACE人脸模糊。
    422ERROR_OBSTRUCTED_FACE人脸被遮挡。
    422ERROR_POOR_FACE_LIGHTING人脸光照不佳。
    422ERROR_INCOMPLETE_FACE人脸不完整。
    422ERROR_FACE_NOT_FACING_FORWARD人脸未正面朝向。
    422ERROR_MISSING_OUTPUT_FORMAT缺少输出格式。
    422ERROR_QUALITY_SCORE_NOT_MEET_REQUIREMENTS质量评分不符合要求。
    422ERROR_QUALITY_CONTROL_ERROR质量控制错误。
    422ERROR_LIVENESS_CONTROL_ERROR活体检测错误。
    422ERROR_SCENE_TYPE_MISMATCH场景类型不匹配。
    422ERROR_CARTOON_FACE_NOT_SUPPORTED不支持卡通人脸。
    422ERROR_TEMPLATE_IMAGE_QUALITY_TOO_LOW模板图像质量过低。
    422ERROR_ACTION_VERIFICATION_FAILED动作验证失败。
    422ERROR_LEFT_EYE_OCCLUSION_TOO_HIGH左眼遮挡过高。
    422ERROR_RIGHT_EYE_OCCLUSION_TOO_HIGH右眼遮挡过高。
    422ERROR_LEFT_FACE_OCCLUSION_TOO_HIGH左脸遮挡过高。
    422ERROR_RIGHT_FACE_OCCLUSION_TOO_HIGH右脸遮挡过高。
    422ERROR_CHIN_OCCLUSION_TOO_HIGH下巴遮挡过高。
    422ERROR_NOSE_OCCLUSION_TOO_HIGH鼻子遮挡过高。
    422ERROR_MOUTH_OCCLUSION_TOO_HIGH嘴部遮挡过高。
    422ERROR_SYNTHESIS_DETECTION_FAILED合成检测失败。
    422ERROR_LIVENESS_DETECTION_FAILED活体检测失败。
    422ERROR_NO_RECOGNITION_TARGET_DETECTED图像中未检测到识别目标。
    422ERROR_IMAGE_RECOGNITION_FAILED图像识别错误。
    422ERROR_MASK_IMAGE_RESOLUTION_MISMATCHmask和image的分辨率必须相同。
    422ERROR_TASK_STOPPED_PROCESSING任务已停止处理。
    422EXCEEDING_LIMITS超出限制。
    422ERROR_CONTENT_NON_COMPLIANCE内容不符合要求。
    429ERROR_NOT_ENOUGH_CREDITS积分不足。
    500UNKNOWN_ERROR未知错误。请稍后重试，如未及时解决请联系平台。
    500SERVICE_INTERNAL_ERROR服务内部错误。请稍后重试，如未及时解决请联系平台。
    500FILE_SERVICE_ERROR文件服务错误。请稍后重试，如未及时解决请联系平台。
    500AI_SERVICE_ERRORAI服务错误。请稍后重试，如未及时解决请联系平台。
    500AI_SERVICE_INTERNAL_ERRORAI服务内部错误。请稍后重试，如未及时解决请联系平台。
    502ERROR_GATEWAY网关错误，请稍后重试。如未及时解决请联系平台。
    503AI_SERVICE_FLOW_RESTRICTIONAI服务限流。请稍后重试，如未及时解决请联系平台。
    504AI_SERVICE_TIMEOUTAI服务超时。请稍后重试，如未及时解决请联系平台。