图像重采样算子用于对输入图像进行尺寸重采样（仅支持降采样），并将结果保存到用户指定的 TOS 目录。支持 4 种插值算法（nearest/bilinear/bicubic/lanczos）与 .jpg / .png 输出格式，适用于图像预处理、数据标准化、离线数据集构建等场景。

算子介绍

核心能力

多种插值算法

nearest：速度最快，适合像素风格图像

bilinear：速度与质量平衡

bicubic：更平滑的高质量缩放

lanczos：抗锯齿效果更好，适合照片

URL / TOS 输入支持

image_src_type=image_url：输入公网 URL

image_src_type=image_tos：输入 tos:// 地址

输出到 TOS

tos_dir 必填，指定输出目录（文件夹级别）

输出文件名由服务端生成（可通过 image_name 辅助命名），并追加 _resample 后缀标识

输出格式与 DPI 控制

输出格式支持 .jpg / .png

支持设置输出 DPI（target_dpi）效果展示

支持的地域

北京：cn-beijing

上海：cn-shanghai

广州：cn-guangzhou

算子性能

细分项	性能影响说明
最大 RPM	600

输入与输出要求

输入要求

细分	详细要求
支持的输入数据模态	图片
输入格式：图片	格式：JPEG/PNG/TIFF（JPG/TIF 作为别名支持）大小：文件大小不超过 100MB；像素总数不超过 225,000,000。
输入路径要求	通过请求参数 image 提供输入图像，支持可访问的 HTTP/HTTPS URL 或 TOS 路径。公网 URL 不支持需要登录态或额外 Header 鉴权的地址；临时 URL 需在处理期间有效。 TOS 对象需与当前 LAS 服务同主账号、同地域，且具备读取权限；路径格式为 tos://bucket_name/path/to/image。

输出要求

细分	详细要求
输出数据模态	图片
输出格式：图片	格式：.jpg、.png 尺寸：target_size 必须包含两个正整数；输出总像素不超过 36,000,000，且宽高均不得超过原图。算子不会自动保持原图宽高比。 DPI：target_dpi 只设置输出文件的 DPI 元数据，不改变输出像素尺寸。
输出路径：TOS	通过请求参数 tos_dir 指定具备写权限的 TOS 输出目录，格式为 tos://bucket/output/。接口返回的 image_path 是输出图像的完整 TOS 路径，无需调用方再次拼接。

计费说明

计费标准

细分项	计费标准说明
计费项	基于输入图片的张数统计用量，并进行计费。
计费类型	按量计费，单位：元/百万张，按实际的计费用量每小时出账。
单价	与输入的图片分辨率有关。

计费详情

计费公式：总费用 = 单价 * 用量

细分场景
单价
输入的图片分辨率：16k
600 元/百万张
输入的图片分辨率：12k
350 元/百万张
输入的图片分辨率：4k
50 元/百万张

注意与前提

细分项	注意与前提
开通 LAS	如果您是一个全新的火山引擎用户，此前未开通过 LAS 产品，您可先开通 LAS，不使用 LAS 的计费功能仅开通 LAS 产品不会产生费用。开通操作请参见准备工作。开通完成后可查看算子介绍文档，了解算子能力、上手引导等，详情可参见：LAS 智能数据处理算子。
费用	调用算子前，您需先了解使用算子时的模型调用费用，详情请参见大模型调用计费。
鉴权（API Key）	调用算子前，您需要先生成算子调用的API Key，并建议将API Key配置为环境变量，便于更安全地调用算子，详情请参见获取 API Key 并配置。
BaseURL	调用算子前，您需要先根据您当前使用的LAS服务所在地域，了解算子调用的BaseURL，用于配置算子调用路径参数取值。详情请参见获取 Base URL，下文中的调用示例仅作为参考，实际调用时需替换为您对应地域的路径取值。

Rest API 调用

接口说明

调用 las_image_resample 算子对输入图像进行重采样（仅支持降采样），并将结果保存到用户指定的 TOS 目录。

请求参数

operator_id string 必选示例值: las_image_resample

本算子的 id 是 las_image_resample。

operator_version string 必选示例值: v1

目前只支持 v1。

data process_param 必选

算子参数。

image_src_type string Optional 示例值: image_url

输入图像类型，支持 image_url / image_tos，默认 image_url。

image string 必选示例值: https://example.com/a.jpg

输入图像地址。image_src_type=image_url 时传可访问的 HTTP/HTTPS URL；image_src_type=image_tos 时传 tos:// 地址。支持 JPEG、PNG、TIFF 格式（包括 JPG、TIF 别名）；文件大小不超过 100MB，像素总数不超过 225,000,000。

image_name string Optional 示例值: sample

输出文件基础名，可选，不应包含扩展名。仅支持 A-Za-z0-9._-，长度不超过 256，且不允许包含 ..。最终文件名为“基础名 + _resample + image_suffix”；不传时由服务端根据输入信息生成。同一输出路径已存在同名文件时会覆盖。

tos_dir string 必选示例值: tos://your-bucket/path/to/dir

输出 TOS 目录（文件夹级别），必填且不能为空。重采样结果会写入该目录。

image_suffix string Optional 示例值: .jpg

输出图像格式，支持 .jpg / .png，默认 .jpg。

target_size list of integer Optional 示例值: [200, 200]

输出图像尺寸 [width, height]，单位为像素，必须恰好包含两个正整数，默认 [200, 200]，输出总像素不得超过 36,000,000。仅支持降采样：输出宽度不得超过原图宽度，输出高度不得超过原图高度。算子不会自动保持原图宽高比。如默认尺寸超过原图尺寸，请显式传入更小的 target_size。

target_dpi list of integer Optional 示例值: [72, 72]

输出图像 DPI [x_dpi, y_dpi]，必须恰好包含两个正整数，默认 [72, 72]。该参数只设置输出文件的 DPI 元数据，不改变 target_size 指定的像素尺寸。

method string Optional 示例值: lanczos

重采样插值算法，支持 nearest / bilinear / bicubic / lanczos，默认 lanczos。

返回数据

metadata metadata

请求的元信息。

task_status string 示例值: COMPLETED

任务状态。本接口为同步调用：处理成功时返回 COMPLETED，处理失败时返回 FAILED。

business_code string 示例值: 0

业务码。

error_msg string

如有异常，会返回详细的异常信息。

request_id string 示例值: 9fed0e5f0659b128bad47e971aed3c81

请求的 request_id。

data result

处理成功时返回结果数据；处理失败时不返回该字段。

image_path string 示例值: tos://your-bucket/path/to/dir/xxx.jpg

输出图像在 TOS 上的完整存储路径，已包含输出目录、服务端生成的文件名和 image_suffix，调用方无需自行拼接。

示例

请求示例

返回示例

Daft 调用

算子参数

输入

输入列名	说明
image	包含输入图像的数组，支持URL/base64/二进制格式
image_name	可选参数，包含图像标识名的数组，用于生成输出文件名。建议传入以确保文件名唯一性，且不要带后缀；如果不传入，会为无法解析出名称的图片随机生成名称。

输出

包含处理结果的字典数组，每个元素包含：

base64: 重采样后图像的base64编码；

image_path: 本地/TOS存储路径（当配置输出目录时有效）

参数

如参数没有默认值，则为必填参数

参数名称	类型	默认值	描述
image_suffix	str	.jpg	保存到 TOS 中的图像格式。描述: 保存到 TOS 中的图像格式，默认为'.jpg' 可选值: [".jpg", ".png"] 默认值: ".jpg"
tos_dir	str		保存图像的 TOS 文件夹路径。描述: 将重采样后的图像保存到的 TOS 路径，如果不设置，则不会将重采样后的图像保存到 TOS 中。默认值: ""
local_dir	str		保存图像的本地文件夹路径。描述: 调整后图像的本地存储目录，如果为空，则调整后的图像不保存到本地。默认值: ""
image_src_type	str	image_url	输入图像的格式类型，支持： - url地址(image_url) - base64编码(image_base64) - 二进制流(image_binary) 描述: 输入图像的格式类型。可选值: ["image_url", "image_base64", "image_binary"] 默认值: "image_url"
target_size	list	[200, 200]	重采样后的图像尺寸。描述: 重采样后的图像尺寸，格式为 [width, height]，默认为 [200, 200]。默认值: [200, 200]
target_dpi	list	[72, 72]	图像 DPI。描述: 图像 DPI，格式为 [width, height]，默认为 [72, 72]。默认值: [72, 72]
method	str	lanczos	重采样方法。描述: 重采样方法，支持 nearest(最近邻插值)、bilinear(双线性插值)、bicubic(双三次插值)、lanczos(Lanczos插值)，默认为 lanczos。可选值: ["nearest", "bilinear", "bicubic", "lanczos"] 默认值: "lanczos"

调用示例

下面的代码展示了如何使用 daft 运行算子对图像做重采样。

细分场景	单价
输入的图片分辨率：16k	600 元/百万张
输入的图片分辨率：12k	350 元/百万张
输入的图片分辨率：4k	50 元/百万张

AI 数据湖服务