POST /image-tune/inpaint/v1
用途
此端点使用 AI 自然更改图像的特定部分。基于上传的图像和提示修改指定区域，生成所需的结果。
方法和路径
- HTTP Method:
POST - Path:
/public/v1/image-tune/inpaint/v1
认证
此端点需要 Bearer Token 认证。详情请参阅 认证指南。
必需头信息：
Authorization: Bearer {your_api_key}
请求字段
表单数据 (multipart/form-data)
| 字段名 | 类型 | 必需 | 说明 |
|---|---|---|---|
image | file | 必需 | 要修复的原始图像文件 (PNG, JPG, JPEG 等) |
prompt | string | 必需 | 描述修复内容的文本提示 |
提示指南
- 具体描述要修复的区域和想要的结果
- 例如:
"将背景更改为蓝天","移除右上角的物体"
响应
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，实际修复处理在后台进行。
作业流程：
- 发送图像文件和提示后立即返回
job_id - 后台进行修复处理
- 使用
GET /job/{job_id}端点轮询检查状态 - 当
status变为Succeed时，从image_urls查看结果图像 URL
轮询间隔： 建议 1-2 秒
请求示例
cURL
curl -X POST "https://api.aetherforgeai.com/public/v1/image-tune/inpaint/v1" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/your/image.png" \
-F "prompt=将背景更改为蓝天"
响应示例
{
"job_id": "550e8400-e29b-41d4-a716-446655440000"
}