目的 - Claid AI

了解如何控制产品图像的定位。

产品图像

AI Photoshoot API 支持多种选项来提供需要处理的源图像。

您必须上传没有 背景的****图像 ，因此您可以使用 Claid API背景去除。

如果您选择上传带有背景的图像，则场景将围绕整个图像创建。

HTTP(S) 网址

输入图片的 URL 应为 1 到 4096 个字符。该图片必须可供我们的系统访问。

复制

{
    "object": {
        "image_url": "https://letsenhance.io/docs/assets/samples/burger.jpg"
    }
}

联网存储

您可以连接云存储并将其用作图片来源。目前，我们的 API 支持 AWS S3 和 Google Cloud Storage。

连接云存储后，您可以将存储名称作为输入。

复制

{
    "object": {
        "image_url": "storage://storage-name/path/image.jpg"
    }
}

输入图像文件类型

API 支持以下图像格式作为输入：BMP、GIF、JPEG、PNG、TIFF、WEBP、AVIF 和 HEIC。

JPEG 不支持背景透明度，因此您可能需要选择其他图像格式。

放置

有多种放置类型可用于在场景中定位对象。其中一些允许使用附加参数来实现更准确的定位。

展示位置类型	描述
`"absolute"`	绝对放置类型允许根据相关参数（例如、和）手动定义产品位置`position`。`scale`默认情况下`rotation_degree`使用。
`"original"`	原始展示位置类型使产品在生成的图像上的位置与在输入图像上的位置保持相同。

绝对位置

绝对放置是一种使用一个或多个相关字段手动调整对象位置的方法：位置、比例和旋转度。默认情况下使用它，以便placement_type可以省略或明确指定字段。

复制

{
    "object": {
        "image_url": "storage://storage-name/path/image.jpg",
        "placement_type": "absolute",
        "position": {
            "x":0.6, 
            "y":0.4
        },
        "scale": 0.4,
        "rotation_degree": 90.0
    }
}

旋转度

您可以通过指定选项对对象进行 360 度旋转rotation_degree。

物体将以顺时针方向旋转至0度360。

复制

{
    "object": {
        "image_url": "storage://storage-name/path/image.jpg",
        "rotation_degree": 90.0
    }
}

规模

您可以通过指定选项来更改对象相对于背景的大小scale。

默认情况下，对象会缩放到生成背景的边缘，相当于设置scale为1.0。

如果您愿意，可以将对象缩小到生成背景总宽度和高度的 10％，这相当于设置scale为0.1。

复制

{
    "object": {
        "image_url": "storage://storage-name/path/image.jpg",
        "scale": 0.4
    }
}

位置

您可以通过选项指定相对对象位置来在图像周围移动对象position。

默认情况下，对象位于图像的中心，对应于{"x":0.5, "y":0.5}。

定位并不是一个直观的概念，因此下面是定位对象的参考表：

左上角："x":``0.0``, "y":``0.0	顶部边缘："x":``0.5``, "y":``0.0	右上角："x":``1.0``, "y":``0.0
左边缘："x":``0.0``, "y":``0.5	中心："x":``0.5``, "y":``0.5	右边缘："x":``1.0``, "y":``0.5
左下角："x":``0.0``, "y":``1.0	底边："x":``0.5``, "y":``1.0	右下角："x":``1.0``, "y":``1.0

复制

{
    "object": {
        "image_url": "storage://storage-name/path/image.jpg",
        "position": {
            "x":0.6, 
            "y":0.4
        }
    }
}

可能值

范围	类型	范围	默认值
`image_url`	字符串	1 - 4096	是必须的
`rotation_degree`	漂浮	0.0 - 360.0	0.0
`scale`	漂浮	0.0 - 1.0	1.0
`position.x`	漂浮	0.0 - 1.0	0.5
`position.y`	漂浮	0.0 - 1.0	0.5

原始放置

原始位置是当原始图片上的透明背景产品已经有所需位置时的一种选择。这意味着将生成背景，而产品将保持在原始图片上的相同位置。

此展示位置类型不需要任何其他字段。

复制

{
    "object": {
        "image_url": "storage://storage-name/path/image.jpg",
        "placement_type": "original"
    }
}

左上角："x":``0.0``, "y":``0.0	顶部边缘："x":``0.5``, "y":``0.0	右上角："x":``1.0``, "y":``0.0
左边缘："x":``0.0``, "y":``0.5	中心："x":``0.5``, "y":``0.5	右边缘："x":``1.0``, "y":``0.5
左下角："x":``0.0``, "y":``1.0	底边："x":``0.5``, "y":``1.0	右下角："x":``1.0``, "y":``1.0

目的

产品图像#

HTTP(S) 网址#

联网存储#

输入图像文件类型#

放置#

绝对位置#

旋转度#

规模#

位置#

可能值#

原始放置#