> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihairstyle.cn/llms.txt
> Use this file to discover all available pages before exploring further.
# 响应说明
> 了解AI发型设计 API的响应格式和错误代码
# 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` | [查看](#error-detail-code) | 错误代码。 |
| +`code_message` | 是 | `string` | | 错误代码(`code`)表示的信息。 |
| +`message` | 是 | `string` | | `code_message`字段的补充信息。 |
## 如何验证请求是否成功？
* 使用HTTP状态码：
* **200**: 成功。
* **其他**: 失败。
* 使用`error_code`字段：
* **0**: 成功。
* **其他**: 失败。
```json theme={null}
{
"request_id": "请求ID",
"log_id": "日志ID",
"error_code": 0,
"error_detail": {
"status_code": 200,
"code": "",
"code_message": "",
"message": ""
}
}
```
```json theme={null}
{
"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状态 | 错误代码 | 描述 |
| :----- | :------------------------------------------ | :-------------------------- |
| 400 | `PROCESSING_FAILURE` | 处理失败。 |
| 400 | `ERROR_PARAMETERS` | 无效参数。 |
| 400 | `MISSING_PARAMETERS` | 缺少参数。 |
| 400 | `ERROR_INVALID_PARAMETER` | 无效参数。 |
| 400 | `PARAMETERS_CANNOT_EMPTY` | 参数不能为空。 |
| 400 | `ERROR_MISSING_LIMIT_PARAMETER` | 缺少Limit参数。 |
| 400 | `ERROR_MISSING_TASKS_PARAMETER` | 缺少Tasks参数。 |
| 400 | `ERROR_MISSING_ASSURE_DIRECTION_PARAMETER` | 缺少AssureDirection参数。 |
| 400 | `ERROR_MISSING_MIN_HEIGHT_PARAMETER` | 缺少MinHeight参数。 |
| 400 | `ERROR_INVALID_SIDE_PARAMETER` | Side参数值无效。 |
| 400 | `ERROR_TOO_MANY_FILES` | 文件数量超出限制。 |
| 400 | `ERROR_FACE_TRACE_LIMIT_EXCEEDED` | 人脸或追踪限制超出。 |
| 400 | `ERROR_INVALID_URL` | 无效的URL。 |
| 400 | `ERROR_DATABASE_LIMIT_EXCEEDED` | 数据库限制超出。 |
| 400 | `ERROR_INVALID_RESPONSE_FORMAT` | 响应格式错误（不支持的Accept）。 |
| 400 | `ERROR_UNSUPPORTED_RESPONSE_FORMAT` | 响应格式错误（不支持的格式）。 |
| 400 | `ERROR_TOO_MANY_GROUPS_IN_GROUP_LIST` | group\_list中组数过多。 |
| 400 | `ERROR_TOO_MANY_UIDS_IN_UID_LIST` | uid\_list中UID数量过多。 |
| 400 | `ERROR_TOO_MANY_APPS_IN_APP_LIST` | app\_list中应用数量过多。 |
| 400 | `ERROR_BATCH_TASK_LIMIT_EXCEEDED` | 批量任务处理限制超出。 |
| 400 | `ERROR_CLEANING_USER_GROUP_DATA` | 正在清理用户组数据。 |
| 400 | `ERROR_IMAGE_STORAGE_NOT_SUPPORTED` | 不支持图片存储。 |
| 400 | `ERROR_INSUFFICIENT_RESOURCES` | 资源不足。 |
| 400 | `ERROR_RESOURCE_IN_TRANSIT` | 资源传输中。 |
| 400 | `ERROR_FILE_DOWNLOAD_FAILED` | 文件下载失败。 |
| 400 | `ERROR_FILE_UPLOAD_FAILED` | 文件上传失败。 |
| 400 | `FILE_DECODING_FAILURE` | 文件解码失败。 |
| 400 | `ERROR_FACE_BLENDING_FAILED` | 人脸融合失败。 |
| 400 | `ERROR_FACE_IMAGE_ADDITION_FAILED` | 添加人脸图像失败。 |
| 400 | `ERROR_GET_FACE_IMAGE_FAILED` | 获取人脸图像失败。 |
| 400 | `ERROR_DATA_TRANSFER_FAILED` | 数据传输（下载或上传）失败。 |
| 400 | `ERROR_TASK_REVOCATION_FAILED` | 任务撤销失败。 |
| 400 | `ERROR_RESOURCE_UNAVAILABLE` | 资源暂时不可用。 |
| 400 | `ERROR_FILE_DOWNLOAD_TIMEOUT` | 文件下载超时。 |
| 401 | `ERROR_USER_NOT_EXISTS` | 用户不存在。 |
| 401 | `ERROR_APPLICATIONS_NOT_EXISTS` | 应用程序不存在。 |
| 403 | `ERROR_USER_LOCKED` | 用户已被锁定。 |
| 403 | `AI_SERVICE_UNAUTHORIZED` | AI服务未授权。请稍后重试，如未及时解决请联系平台。 |
| 403 | `ERROR_ILLEGAL_FILE` | 非法文件。 |
| 404 | `ERROR_AI_NOT_EXISTS` | AI不存在或已被停用，请联系平台。 |
| 404 | `AI_SERVICE_NOT_FOUND` | 找不到AI服务。请稍后重试，如未及时解决请联系平台。 |
| 404 | `ERROR_FILE_NOT_FOUND` | 找不到文件。 |
| 404 | `ERROR_FACE_NOT_FOUND` | 找不到人脸。 |
| 404 | `ERROR_USER_GROUP_NOT_FOUND` | 找不到用户组。 |
| 404 | `ERROR_USER_NOT_FOUND` | 找不到用户。 |
| 404 | `ERROR_FACE_TOKEN_NOT_FOUND` | 找不到人脸令牌。 |
| 404 | `ERROR_CONTENT_NOT_FOUND` | 找不到内容。 |
| 404 | `ERROR_RESOURCE_NOT_FOUND` | 找不到资源。 |
| 405 | `ERROR_ILLEGAL_OPERATION` | 非法操作。 |
| 409 | `ERROR_FACE_ALREADY_EXISTS` | 人脸已存在。 |
| 409 | `ERROR_DATA_ALREADY_EXISTS` | 数据已存在。 |
| 409 | `ERROR_USER_GROUP_ALREADY_EXISTS` | 用户组已存在。 |
| 409 | `ERROR_USER_ALREADY_EXISTS` | 用户已存在。 |
| 409 | `ERROR_DUPLICATE_GROUP_NAME` | 重复的组名。 |
| 409 | `ERROR_RESOURCE_IN_USE` | 资源正在使用中。 |
| 409 | `ERROR_TASK_CONFLICT` | 任务冲突。 |
| 409 | `ERROR_TASK_REVOKED` | 任务已被撤销。 |
| 410 | `ERROR_RESOURCE_RECLAIMED` | 资源已被回收。 |
| 413 | `FILE_SIZE_EXCEEDS_LIMIT` | 文件大小超出限制。 |
| 413 | `ERROR_CONTENT_TOO_LONG` | 内容长度超出限制。 |
| 413 | `ERROR_VIDEO_DURATION_EXCEEDED` | 视频时长超出限制。 |
| 413 | `ERROR_REQUEST_BODY_TOO_LARGE` | 请求体大小超出限制。 |
| 413 | `ERROR_RESPONSE_BODY_TOO_LARGE` | 响应体大小超出限制。 |
| 415 | `UNSUPPORTED_FILE_TYPES` | 不支持的文件类型。 |
| 415 | `ERROR_INVALID_OUTPUT_FORMAT` | 无效的输出格式。 |
| 415 | `ERROR_UNSUPPORTED_GRAYSCALE_IMAGE` | 不支持灰度图像。 |
| 422 | `UNSUPPORTED_PARAMETER_VALUES` | 不支持的参数值。 |
| 422 | `ERROR_INVALID_FACE_BOX_PARAMETER` | 人脸框参数不符合要求。 |
| 422 | `ERROR_INVALID_BIG_EYES_PARAMETER` | 大眼参数不符合要求。 |
| 422 | `ERROR_INVALID_FACE_SLIMMING_PARAMETER` | 瘦脸参数不符合要求。 |
| 422 | `ERROR_INVALID_SMOOTHING_PARAMETER` | 光滑参数不符合要求。 |
| 422 | `ERROR_INVALID_SKIN_WHITENING_PARAMETER` | 美白参数不符合要求。 |
| 422 | `ERROR_INVALID_PARAMETER_FORMAT` | 无效的参数格式。 |
| 422 | `ERROR_PARAMETER_CONVERSION_FAILED` | 参数转换失败。 |
| 422 | `FILE_RESOLUTION_EXCEEDS_LIMITS` | 文件分辨率超出限制。 |
| 422 | `ERROR_LOW_RESOLUTION` | 文件分辨率过低。 |
| 422 | `ERROR_HIGH_RESOLUTION` | 文件分辨率过高。 |
| 422 | `ERROR_INVALID_FILE` | 无效文件。 |
| 422 | `FILE_CONTENT_NON_COMPLIANCE` | 文件内容不符合要求。 |
| 422 | `ERROR_INCORRECT_FILE_COUNT` | 文件数量不正确。 |
| 422 | `ERROR_NO_FACE_IN_FILE` | 文件中未检测到人脸。 |
| 422 | `ERROR_FACE_SIZE_NOT_MEET_REQUIREMENTS` | 人脸大小不符合要求。 |
| 422 | `ERROR_FACE_SIZE_RATIO_NOT_MET` | 人脸大小比例不符合要求。 |
| 422 | `ERROR_SMALL_FACE_SIZE` | 人脸太小。 |
| 422 | `ERROR_FACE_COPY_SCENE_MISMATCH` | 人脸复制场景类型不匹配。 |
| 422 | `ERROR_FACE_UNRECOGNIZABLE` | 无法识别人脸。 |
| 422 | `ERROR_POOR_FACE_QUALITY` | 人脸质量差。 |
| 422 | `ERROR_BLURRY_FACE` | 人脸模糊。 |
| 422 | `ERROR_OBSTRUCTED_FACE` | 人脸被遮挡。 |
| 422 | `ERROR_POOR_FACE_LIGHTING` | 人脸光照不佳。 |
| 422 | `ERROR_INCOMPLETE_FACE` | 人脸不完整。 |
| 422 | `ERROR_FACE_NOT_FACING_FORWARD` | 人脸未正面朝向。 |
| 422 | `ERROR_MISSING_OUTPUT_FORMAT` | 缺少输出格式。 |
| 422 | `ERROR_QUALITY_SCORE_NOT_MEET_REQUIREMENTS` | 质量评分不符合要求。 |
| 422 | `ERROR_QUALITY_CONTROL_ERROR` | 质量控制错误。 |
| 422 | `ERROR_LIVENESS_CONTROL_ERROR` | 活体检测错误。 |
| 422 | `ERROR_SCENE_TYPE_MISMATCH` | 场景类型不匹配。 |
| 422 | `ERROR_CARTOON_FACE_NOT_SUPPORTED` | 不支持卡通人脸。 |
| 422 | `ERROR_TEMPLATE_IMAGE_QUALITY_TOO_LOW` | 模板图像质量过低。 |
| 422 | `ERROR_ACTION_VERIFICATION_FAILED` | 动作验证失败。 |
| 422 | `ERROR_LEFT_EYE_OCCLUSION_TOO_HIGH` | 左眼遮挡过高。 |
| 422 | `ERROR_RIGHT_EYE_OCCLUSION_TOO_HIGH` | 右眼遮挡过高。 |
| 422 | `ERROR_LEFT_FACE_OCCLUSION_TOO_HIGH` | 左脸遮挡过高。 |
| 422 | `ERROR_RIGHT_FACE_OCCLUSION_TOO_HIGH` | 右脸遮挡过高。 |
| 422 | `ERROR_CHIN_OCCLUSION_TOO_HIGH` | 下巴遮挡过高。 |
| 422 | `ERROR_NOSE_OCCLUSION_TOO_HIGH` | 鼻子遮挡过高。 |
| 422 | `ERROR_MOUTH_OCCLUSION_TOO_HIGH` | 嘴部遮挡过高。 |
| 422 | `ERROR_SYNTHESIS_DETECTION_FAILED` | 合成检测失败。 |
| 422 | `ERROR_LIVENESS_DETECTION_FAILED` | 活体检测失败。 |
| 422 | `ERROR_NO_RECOGNITION_TARGET_DETECTED` | 图像中未检测到识别目标。 |
| 422 | `ERROR_IMAGE_RECOGNITION_FAILED` | 图像识别错误。 |
| 422 | `ERROR_MASK_IMAGE_RESOLUTION_MISMATCH` | `mask`和`image`的分辨率必须相同。 |
| 422 | `ERROR_TASK_STOPPED_PROCESSING` | 任务已停止处理。 |
| 422 | `EXCEEDING_LIMITS` | 超出限制。 |
| 422 | `ERROR_CONTENT_NON_COMPLIANCE` | 内容不符合要求。 |
| 429 | `ERROR_NOT_ENOUGH_CREDITS` | 积分不足。 |
| 500 | `UNKNOWN_ERROR` | 未知错误。请稍后重试，如未及时解决请联系平台。 |
| 500 | `SERVICE_INTERNAL_ERROR` | 服务内部错误。请稍后重试，如未及时解决请联系平台。 |
| 500 | `FILE_SERVICE_ERROR` | 文件服务错误。请稍后重试，如未及时解决请联系平台。 |
| 500 | `AI_SERVICE_ERROR` | AI服务错误。请稍后重试，如未及时解决请联系平台。 |
| 500 | `AI_SERVICE_INTERNAL_ERROR` | AI服务内部错误。请稍后重试，如未及时解决请联系平台。 |
| 502 | `ERROR_GATEWAY` | 网关错误，请稍后重试。如未及时解决请联系平台。 |
| 503 | `AI_SERVICE_FLOW_RESTRICTION` | AI服务限流。请稍后重试，如未及时解决请联系平台。 |
| 504 | `AI_SERVICE_TIMEOUT` | AI服务超时。请稍后重试，如未及时解决请联系平台。 |