FacePick 脸谱 · 开放平台

1. 错误响应格式

当 API 请求发生错误时，返回统一的错误响应格式（示例，不会真实返回）：

{
  "code": 401,
  "message": "Unauthorized",
  "request_id": "req_20250820_123456",
  "timestamp": "2025-08-20T10:24:36Z"
}

示例中的 https://api.demo.invalid 与 fp_demo_not_valid_… 均为占位演示值；复制示例不会执行任何网络请求。

HTTP 状态码与 JSON 业务码是两层概念：响应头/状态行的 200、400、401…是 HTTP 状态码；正文里的 error_code 字段（如 UNAUTHORIZED、RATE_LIMITED）是 JSON 业务码。二者都保留，不混为一谈；200 是成功状态，不是错误。

2. 常见错误码列表

以下是 API 常见的错误码及解决方法。支持搜索定位；点击条目可以展开解释，或跳到已有排错文章（401/403/404/429/500/502/503/504 的数据与 23 页「错误排查」共用，避免重复维护矛盾说明）：

HTTP 状态码: 200
JSON 业务码（error_code）: SUCCESS

200 是成功状态，不是错误：表示请求已成功处理，无需采取任何措施。

错误码数据与 23 页「错误排查」共用（401/403/404/429/500/502/503/504）； HTTP 状态码与 JSON 业务码是两层概念，本页分开标注，不混为一谈。

3. 错误处理示例

以下是使用 Python 处理 API 错误的示例代码（演示结构，不会发起真实调用）：

try:
    response = client.face.generate(prompt="商务人士，高清写真")
except FacePickError as e:
    print(f"错误码：{e.code}，错误信息：{e.message}")
    print(f"请求ID：{e.request_id}")
    # 根据错误码进行相应处理

示例中的 https://api.demo.invalid 与 fp_demo_not_valid_… 均为占位演示值；复制示例不会执行任何网络请求。