跳到主要内容

局部重绘 V2

用途​

根据提示词使用 AI 重绘图片的一部分。上传图片并描述需要重绘的内容。此功能与 Web 应用「重绘图片」页面的 V2 标签页相同（默认标签页）。

代币消耗： 3

方法和路径​

POST /public/v1/image-tune/inpaint/v2

认证​

请参阅 认证 页面。需要 Bearer 令牌。

必需头信息：

Authorization: Bearer {your_api_key}

请求字段​

请以 multipart/form-data 形式发送请求。

字段名类型必需说明
imagefile是要重绘的原始图片文件（PNG 或 JPEG）
promptstring是你想重绘哪一部分？提示词会原样发送

提示词指南

  • 详细描述要重绘的区域和想要的结果
  • 例如: "Change background to blue sky", "Remove object in upper right corner"

响应​

成功响应 (200 OK)：

{
  "job_id": "uuid-string"
}
字段类型说明
job_idstring创建的作业的唯一标识符。使用 获取作业状态 查询结果

错误 / 验证规则​

情况HTTP 状态错误消息
图片不是有效的 PNG 或 JPEG 文件400"Invalid image file"
API 密钥无效401"Invalid API key"
缺少字段422验证错误

异步作业行为​

此端点创建异步作业。请求立即返回 job_id，实际的重绘在后台进行。

轮询方法：

  1. 保存响应中收到的 job_id
  2. 轮询 GET /public/v1/job/{job_id} 检查状态
  3. 当状态变为 Succeed 时，从 image_urls 查看结果图片

状态流程： Pending → Succeed 或 Failed

请求示例​

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=Change background to blue sky"

响应示例：

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