Remove-object (物体消除)

智能物体擦除和修复API接口，提供智能物体擦除功能，可以精确移除图片中不需要的物体，并智能填充背景内容，保持画面的自然连贯

📋 基本信息

属性	值
接口地址	`POST /v1/chat/completions`
模型名称	`remove-object`

📝 请求参数

路径	参数	类型	必填	说明	默认
-	`model`	string	✅	模型名称，固定为 `remove-object`	-
-	`messages`	array	✅	消息数组，包含用户输入的文本和图片	-
`messages[]`	`role`	string	✅	消息角色，固定为 `user`	-
`messages[]`	`content`	array	✅	内容数组，包含文本和图片元素	-
`content[]`	`type`	string	✅	内容类型：`text` 或 `image_url`	-
`content[]`	`text`	string	❌	当 type 为 `text` 时的文本内容	`"a person"`
`content[]`	`image_url`	object	❌	当 type 为 `image_url` 时的图片对象	-
`image_url`	`url`	string	✅	图片的URL地址（当type为image_url时必填）	-

注意：remove-object 模型需要两个图片：

第一个图片：遮罩图片（mask），标记要消除的部分
第二个图片：源图片（image），要处理的原始图片

📝 请求示例

curl https://api.xty.app/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxx" \
  -d '{
    "model": "remove-object",
    "messages": [
      {
        "role": "user",
        "content": [
          {"type": "text", "text": "a person"},
          {
            "type": "image_url",
            "image_url": {
              "url": "https://image.xty.app/pbxt/JEd3XamngYYznrLZH70ecBlkKm5ga11IMtKEuKkT6uZ3JkyV/mask_1.png"
            }
          },
          {
            "type": "image_url",
            "image_url": {
              "url": "https://image.xty.app/pbxt/JEd3XXLFAJBo7XiG4aK6BViXwnXRsIO9B32jEoooLJtSzLlp/dog.png"
            }
          }
        ]
      }
    ]
  }'

import requests
import json

url = "https://api.xty.app/v1/chat/completions"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer sk-xxxxx"
}
data = {
    "model": "remove-object",
    "messages": [
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "a person"},
                {
                    "type": "image_url",
                    "image_url": {
                        "url": "https://image.xty.app/pbxt/JEd3XamngYYznrLZH70ecBlkKm5ga11IMtKEuKkT6uZ3JkyV/mask_1.png"
                    }
                },
                {
                    "type": "image_url",
                    "image_url": {
                        "url": "https://image.xty.app/pbxt/JEd3XXLFAJBo7XiG4aK6BViXwnXRsIO9B32jEoooLJtSzLlp/dog.png"
                    }
                }
            ]
        }
    ]
}

response = requests.post(url, headers=headers, data=json.dumps(data))
print(response.json())

from openai import OpenAI
import httpx

client = OpenAI(
    base_url="https://api.xty.app/v1",
    api_key="sk-xxxxx",
    http_client=httpx.Client(
        base_url="https://api.xty.app/v1",
        follow_redirects=True,
    ),
)

response = client.chat.completions.create(
    model="remove-object",
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "a person"},
                {
                    "type": "image_url",
                    "image_url": {
                        "url": "https://image.xty.app/pbxt/JEd3XamngYYznrLZH70ecBlkKm5ga11IMtKEuKkT6uZ3JkyV/mask_1.png"
                    }
                },
                {
                    "type": "image_url",
                    "image_url": {
                        "url": "https://image.xty.app/pbxt/JEd3XXLFAJBo7XiG4aK6BViXwnXRsIO9B32jEoooLJtSzLlp/dog.png"
                    }
                }
            ]
        }
    ]
)

print(response)

fetch('https://api.xty.app/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer sk-xxxxx'
  },
  body: JSON.stringify({
    model: "remove-object",
    messages: [
      {
        role: "user",
        content: [
          {type: "text", text: "a person"},
          {
            type: "image_url",
            image_url: {
              url: "https://image.xty.app/pbxt/JEd3XamngYYznrLZH70ecBlkKm5ga11IMtKEuKkT6uZ3JkyV/mask_1.png"
            }
          },
          {
            type: "image_url",
            image_url: {
              url: "https://image.xty.app/pbxt/JEd3XXLFAJBo7XiG4aK6BViXwnXRsIO9B32jEoooLJtSzLlp/dog.png"
            }
          }
        ]
      }
    ]
  })
})
.then(response => response.json())
.then(data => console.log(data));

📤 响应示例

成功响应

{
  "id": "xty-1704067200000",
  "object": "chat.completion",
  "created": 1704067200,
  "model": "remove-object",
  "choices": [
    {
      "index": 0,
      "finish_reason": "stop",
      "message": {
        "role": "assistant",
        "content": "https://file.xty.app/docs/remove_object.png"
      }
    }
  ],
  "usage": {
    "prompt_tokens": 0,
    "completion_tokens": 0,
    "total_tokens": 0
  }
}

错误响应

{
  "error": {
    "message": "remove-object模型需要两个图片（mask和image），请确保在请求中包含两个图片",
    "type": "invalid_request_error",
    "param": null,
    "code": null
  }
}