AI 微笑救星

接入指南

本指南将带您走完全流程：

AI 微笑救星接口的流程：

接口地址： /s2s/v2.0/task/ai-smile

需要鉴权： Authorization: Bearer YOUR_API_KEY

流程步骤：

1. 准备图片上传：

   • 准备好要上传的自拍照。
   • 调用 File 接口 /s2s/v2.0/file 取得上传 URL 与对应的 file_id。
   • 用提供的上传 URL 把自拍照上传上去。

2. 发起 AI 任务并取得 Task ID：

   • 把 file_id 连同选好的特效配置，通过 HTTP POST 请求送到 /s2s/v2.0/task/ai-smile。
   • 响应会返回一个唯一的任务 ID，用于标识本次调用。

3. 轮询任务状态（持续检查）：

   • 用取得的 task_id 通过 HTTP GET 请求定期轮询任务状态（例如 GET /s2s/v2.0/task/ai-smile/${task_id}）。
   • 持续留意：
     • Task_status = "success"（处理完成）。
     • Task_status = "error"（视情况排查或重试）。
   • 状态转为 success 后，按流程继续往下走。

这套规整的流程能顺畅对接用户输入、自动监控任务，并顺利取回结果。

1. 鉴权

• 请在请求头中以 Bearer Token 方式带上您的 API 密钥：
  Authorization: Bearer YOUR_API_KEY

API Key 可在 https://yce.makeupar.com/api-console/en/api-keys/ 获取。

2. 上传图片

   您可以把文件直接上传到服务器，也可以在 AI 任务参数中提供有效的图片 URL。

   • 上传接口

     POST /s2s/v2.0/file

   如果您已有公开可访问的图片 URL，这一步可以跳过。

3. 创建 AI 微笑救星任务并轮询结果

   图片和完整的特效参数备齐后即可创建任务。接口异步处理请求，您需要轮询任务状态，直到状态变为 success 或 error。

   • 创建任务接口

     POST /s2s/v2.0/task/ai-smile

   • 轮询接口

     GET /s2s/v2.0/task/ai-smile/{task_id}

文件规格与错误码

• AI 微笑救星规格

支持的自拍视角 仅支持单人图片。画面中须有一张清楚可见、尺寸足够大的脸——以长边 640 计算，脸部需超过 32 x 32 像素；拍摄角度的翻滚角须在正负 75 度以内、偏航角须在正负 90 度以内，以免人脸检测失败。

• 支持的格式与尺寸

• 错误码

• 运行环境与依赖

点数消耗