跳转到内容
/
快速入门
最后更新于

快速入门

首先在 https://yce.makeupar.com/ai-api 免费注册一个 YouCam API 账号，然后购买或订阅服务来获取点数。订阅方案、按量付费的点数、用量记录，都可以在 https://yce.makeupar.com/api-console/en/api-keys/ 查看。进入账号页面的 API Key 标签页，就能生成并管理您的 API 密钥，开始使用 YouCam API。

流程步骤：

1. 鉴权

  • 用 Bearer Token 把 API 密钥放进请求头：
    Authorization: Bearer YOUR_API_KEY

API 密钥可以在这里找到：https://yce.makeupar.com/api-console/en/api-keys/。

2. 上传文件，或准备好一个公开的图片 URL

  • 调用 File API
  • 从 File API 的响应中拿到上传地址 requests.url 和与之对应的 file_id
  • 用响应中的 requests.url 把图片上传上去

3. 启动 AI 任务并取得 Task ID：

  • 通过 HTTP POST 请求，把上传的图片和 AI 任务配置一起发送到 /s2s/v2.0/task/skin-analysis。这里以 AI 肤质分析任务为例。
  • 响应中会返回一个唯一的任务 ID，用来标识这一次调用。

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

  • 用拿到的 task_id，通过 HTTP GET 请求定期轮询任务状态（例如 GET /skin-analysis/${task_id}）。这里以 AI 肤质分析任务为例。
  • 持续留意：
    • Task_status = "success"（处理完成）。
    • Task_status = "error"（视情况排解或重试）。
  • 状态一旦变成 success，就相应地推进后续流程。

5. 取得结果

  • 成功响应里会带上结果图片的下载地址。

简介

API 服务器