POST /image-tune/inpaint/v2

用途

此端点使用 AI 自然更改图像的特定部分。基于上传的图像和提示修改指定区域，生成所需的结果。

方法和路径

• HTTP Method: POST
• Path: /public/v1/image-tune/inpaint/v2

认证

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

必需头信息：

Authorization: Bearer {your_api_key}

请求字段

表单数据 (multipart/form-data)

字段名	类型	必需	说明
image	file	必需	要修复的原始图像文件 (PNG, JPG, JPEG 等)
prompt	string	必需	描述修复内容的文本提示
quality	string	必需	质量等级。可用值：standard、pro

提示指南

• 具体描述要修复的区域和想要的结果
• 例如: "将背景更改为蓝天", "移除右上角的物体"

响应

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/inpaint/v2" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/your/image.png" \
-F "prompt=将背景更改为蓝天" \
-F "quality=standard"

响应示例

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