图层分离

用途

此端点将上传的图像分离为图层。基于关键词将图像的特定元素分离，提取为单独的图层。

方法和路径

• HTTP Method: POST
• Path: /public/v1/image-tune/split-layer

认证

此端点需要 Bearer Token 认证。详情请参阅 认证指南。

必需头信息：

Authorization: Bearer {your_api_key}

请求字段

表单数据 (multipart/form-data)

字段名	类型	必需	说明
image	file	必需	要分离为图层的原始图像文件 (PNG, JPG, JPEG 等)
keyword	string	必需	指定要分离元素的关键词

关键词指南

• 输入描述要分离的图像元素的关键词
• 例如: "arm", "body", "leg"

响应

JobIdResponse

字段名	类型	说明
job_id	UUID	创建的作业的唯一标识符。使用此 ID 查询作业状态

错误 / 验证规则

HTTP 状态代码	错误情况	说明
400 Bad Request	Invalid image file	Invalid image file
401 Unauthorized	认证失败	无效的 API 密钥或缺失的认证头信息
404 Not Found	用户不存在	找不到 API 密钥关联的用户
422 Unprocessable Entity	验证失败	必需字段缺失

异步作业行为

此端点异步处理。请求立即返回 job_id，实际图层分离处理在后台进行。

作业流程：

1. 发送图像文件和关键词后立即返回 job_id
2. 后台进行图层分离处理
3. 使用 GET /job/{job_id} 端点轮询检查状态
4. 当 status 变为 Succeed 时，从 image_urls 查看分离的图层图像 URL

轮询间隔： 建议 1-2 秒

请求示例

cURL

curl -X POST "https://api.aetherforgeai.com/public/v1/image-tune/split-layer" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/your/image.png" \
-F "keyword=character"

响应示例

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000"
}