POST /image-tune/inpaint/v1
用途
此端点使用 AI 自然地修改图片的特定部分。基于上传的图片和提示词修改指定区域，生成所需的结果。此功能与 Web 应用「重绘图片」页面的 V1 标签页相同（Web 应用默认打开 V2 标签页）。
代币消耗： 5
方法和路径
- HTTP Method:
POST - Path:
/public/v1/image-tune/inpaint/v1
认证
此端点需要 Bearer Token 认证。详情请参阅 认证指南。
必需头信息：
Authorization: Bearer {your_api_key}
请求字段
表单数据 (multipart/form-data)
| 字段名 | 类型 | 必需 | 说明 |
|---|---|---|---|
image | file | 必需 | 要重绘的原始图片文件 (PNG 或 JPEG) |
prompt | string | 必需 | 描述要重绘内容的文本提示词 |
提示词指南
- 详细描述要重绘的区域和想要的结果
- 例如:
"Change background to blue sky","Remove object in upper right corner"
响应
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=Change background to blue sky"
响应示例
{
"job_id": "550e8400-e29b-41d4-a716-446655440000"
}