FLUX-Makeup API 文档

FLUX-Makeup 提供异步图像编辑能力：AI 美妆。采用异步调用流程：通过 submit_task 提交任务获取 task_id，再通过 query_task 查询任务状态与生成结果。

服务能力对照

公共请求头

Header	类型	必填	说明
Authorization	string	是	Bearer <YOUR_TOKEN>
accept	string	美妆可选	建议为 application/json
Content-Type	string	是	固定为 application/json

图片输入规范

AI 美妆使用 source_image_url 与 template_image_url。

• image_url 支持 http/https 图片 URL。
• URL 形式建议使用非 IP 域名，并以 jpg、jpeg、png 或 bmp 结尾。
• 输入图片最大支持 1024 x 1024 的人脸图，建议使用单人、无遮挡、光照稳定的人像。
• AI 美妆需要同时传源人像与参考妆容图。

1. submit_task 提交任务

提交图像编辑任务。服务端受理后返回 task_id，客户端使用该 ID 查询任务状态与输出结果。

Request Method

POST /v1/submit_task

Request Body

页面简化字段映射

AI 美妆对外接口使用 source_image_url 与 template_image_url，无需传入 input 数组。下表保留其与上游图片类型的对应关系。

简化字段	等价 input 元素	适用能力	说明
source_image_url	{ "type": "input_image", "image_url": "..." }	AI 美妆	源人像图片。
template_image_url	{ "type": "template_image", "image_url": "..." }	AI 美妆	参考妆容模板图。

AI 美妆请求示例

{
  "model": "makeup",
  "time_out": 3600,
  "post_level": 1,
  "seed": 42,
  "source_image_url": "https://p0.ssl.qhimg.com/d/inn/0f8fe14174ba/23.png",
  "template_image_url": "https://p3.ssl.qhimg.com/d/inn/2457abe9177f/2ref.png"
}

Response

平台响应可能包裹在 data 中；以下字段为提交任务成功后的核心字段。

字段	类型	说明
version	string	美妆返回服务实际版本 v4.8。
model	string	美妆返回 makeup_transfer。
task_id	string	可供查询任务结果的任务 ID。
message	string	成功为 success，失败时返回具体原因。
response_status	int	成功为 0，失败为 -1。

2. query_task 查询任务

根据 task_id 查询任务状态。任务完成后，响应中的 output 会返回结果图片。

Request Method

POST /v1/query_task

Request Body

参数	类型	必填	说明
request_id	string	美妆可选	单次查询请求唯一标识，建议使用 uuid4；通过平台调用时可由服务侧生成或透传。
model	string	美妆建议传入	与提交任务保持一致：美妆为 makeup（兼容 makeup_transfer）。
task_id	string	是	submit_task 返回的任务 ID，需要完全一致。

查询请求示例

{
  "model": "makeup",
  "task_id": "flux-task-makeup-xxxxxxxx"
}

Response

平台响应可能包裹在 data 中；以下字段为查询任务的核心字段。

字段	类型	说明
version	string	美妆返回服务实际版本 v4.8。
model	string	美妆返回 makeup_transfer。
task_id	string	查询的任务 ID。
message	string	成功为 success，失败时返回具体原因。
response_status	int	成功为 0，失败为 -1。
generation_time	number	任务生成耗时，单位秒；任务成功时通常大于 0。
remaining_time	number	预计剩余处理时间，单位秒。
status	string	任务状态，见下方状态说明。
image_urls	string[]	任务完成后的结果图 URL 列表。
usage	object	计费字段，包含 prompt_tokens 和 total_tokens。
output	string[]	美妆返回 string[]，与 image_urls 一致。

status 状态

状态	说明
done	任务处理完成并得到期望结果。
generating	任务正在 GPU 服务推理。
in_queue	任务正在排队。
not_found	任务未找到，可能任务丢失、提交超过一个月或 task_id 不存在。
failed	任务失败，具体原因查看 message，可能是超时、GPU 服务异常或图片错误。

output 字段

能力	类型	说明
AI 美妆	string[]	与 image_urls 一致，返回完成妆容迁移后的图片地址，默认 1 张。