Logo

背景替换

隔离主体并生成一个全新的、逼真的背景。

背景替换

背景替换端点允许您从图像中隔离出主体，并根据文本提示生成一个全新的、逼真的背景。

模型名称: background-replace

生命周期: stable

处理时间: ~5s–15s

输出格式: Auto (JPEG or PNG)

交付方式: URL

积分: 每次生成 1 到 5 个积分（取决于质量）

请求

将您的背景替换配置提交到通用 /v1/run 端点：

POSThttps://fititon.app/api/v1/run

请求示例

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "background-replace",
           "inputs": {
             "subjectImage": "https://example.com/product.jpg",
             "scenePrompt": "Product sitting on a sandy beach during golden hour",
             "quality": "2k"
           }
         }'

响应

返回 201 Created 状态以及初始跟踪对象。生成过程异步运行。

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": null
}

一旦 status 变为 "succeeded"（通过轮询 GET 端点），output 字段将包含一个数组，其中包含指向您生成的背景的 URL：

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "succeeded",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": [
    "https://cdn.fititon.app/users/123/results/bg-replace-123.png"
  ]
}

请求参数

必填参数

subjectImageRequiredstring

包含您要隔离的主体的图像。可以是公开可访问的 URL 或 Base64 编码的图像字符串。最大尺寸：25MB。

专业提示： 主体与对比鲜明的背景之间具有清晰、锐利边缘的图像可以获得最干净的抠图。避免主体融入背景的图像（例如，白色衬衫在白色墙壁上）。高对比度照明有助于 AI 依靠边缘检测完美分离主体。

格式要求 提交 Base64 字符串时，必须包含标准数据 URI 前缀（例如，data:image/jpeg;base64,...）。

scenePromptRequiredstring

您希望在主体后面生成的新背景场景的文本描述。

可选参数

quality'1k' | '2k' | '4k'

输出分辨率等级。定义最终生成图像的分辨率。 默认值：1k

运行时错误

此功能的运行时错误使用 错误处理 中记录的共享集。如果在处理过程中发生错误，status 将更新为 "error"，并且 error 字段将包含具体的失败原因。

积分成本

对于开发者 API 请求，成本完全取决于所选的输出 quality 等级。

公式： 成本 = 质量积分

质量等级每张图像积分
1k (默认)1
2k3
4k5