AI 胡型生成器

接入指南

1. 上传自拍 源图有两种提供方式：

• 使用已有的公开图片 URL 不必上传，发起 AI 任务时直接给一个可公开访问的图片 URL 即可。

• 通过 File 接口上传 接口地址：

  POST /s2s/v2.0/file

  这会返回一个 file_id，供后续执行任务时使用。

  • 重要：只调用 File 接口并不等于上传了文件。您必须手动把文件上传到 File 接口响应中给出的那个 URL，那个 URL 就是您的上传目标，务必确认文件已成功传过去，再继续往下做。
    
    调用 AI 接口之前，请确认文件已上传成功。先用 File 接口取到一个上传 URL，把文件上传到该位置。上传完成后，您会在响应中收到一个 file_id，调用与该文件相关的 AI 功能时就用它。

    警告： 请注意，若未把文件上传到 File 接口响应中给出的 URL，调用 AI 接口时会得到 500 Server Error / unknown_internal_error 或 404 Not Found 错误。

2. 获取预设风格列表

   • 调用 /s2s/v2.0/task/template/beard-style 取得预设模板列表，挑一个 template_id 用于执行 AI 任务。

3. 执行 AI 任务并取得 Task ID 用 /s2s/v2.0/task/beard-style 执行 AI 任务。目标用户图请提供 src_file_url 或 src_file_id，再给出要套用的风格 template_id，即可取得 task_id。

4. 轮询任务状态，直到成功或失败 用 task_id 轮询 GET /s2s/v2.0/task/beard-style 监控任务状态，取得引擎当前的处理进度。引擎完成任务之前，状态会一直是 running，这一阶段不消耗点数。 您也可以实现 Webhook，在 AI 任务成功或失败时收到通知。细节见 Webhook 一节。

   警告： 在任务保留期内轮询任务状态是必须做的。保留期内没有任何轮询请求，任务就会超时，即使任务已处理成功也一样，而您的点数照样会被消耗。

   警告： 若去查询已超时任务的状态，会收到 InvalidTaskId 错误。因此，执行 AI 任务之后，必须在保留期内持续轮询，直到状态变为 success 或 error。

5. 任务成功后取回结果 引擎处理完您的输入文件、生成出图后，任务状态会变为 success，您会收到一张处理后图片的 URL。

文件规格与错误码

• 支持的格式与尺寸

• 错误码

• 运行环境与依赖

点数消耗