文档Dynamic Media图像服务和渲染API

格式 fmt

Last update: Thu Mar 19 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • 开发人员
  • 用户

响应图像格式。

fmt=format[, [pixelType]，[compression]]

format - avif-alpha | avif | eps | f4m | gif-alpha | gif | gif | heic | jpeg | jpeg2000-alpha | jpeg2000 | jpegxr-alpha | jpegxr | jpg | m3u8 | pdf | pjpeg | png-alpha | png8-alpha | png8 | swf-alpha | swf3-alpha | swf3 | tif-alpha | web-alpha | webp

format
说明
avif-alpha
带有Alpha通道的有损无损AVIF。
avif
有损、无损的AVIF。
eps
未压缩的二进制文件封装的PostScript。
f4m
Flash Streaming Server清单格式。
gif-alpha
GIF具有2到255色和关键色透明度。
gif
GIF，2到256色。
heic
无损HEIC。 如果不支持此格式，则默认从浏览器下载。
jpeg
JPEG的亏损。
jpeg2000-alpha
带Alpha通道的有损无损JPEG 2000。
jpeg2000
无损的JPEG 2000。
jpegxr-alpha
带有Alpha通道的JPEG XR有损和无损。
jpegxr
无损的JPEG XR。
jpg
JPG的亏损。
m3u8
Apple流服务器清单格式。
pdf
PDF中嵌入的图像。
pjpeg
渐进式JPEG。
png-alpha
带有Alpha通道的24位无损PNG。
png
24位无损PNG。
png8-alpha
带有Alpha通道的8位无损PNG。
png8
8位无损PNG。
swf-alpha
嵌入到Adobe AS2 swf文件中的有损JPEG和deflate-compressed掩码。
swf
嵌入到Adobe AS2 swf文件中的有损JPEG。
swf3-alpha
嵌入到Adobe AS3 swf文件中的有损JPEG和deflate-compressed掩码。 注意： swf和swf-alpha格式最适合用于ActionScript 2应用程序（Flash Player 8及更早版本）。 对于ActionScript3应用程序（Flash Player 9及更高版本），建议使用swf3和swf3-alpha格式。
swf3
嵌入到Adobe AS3 swf文件中的有损JPEG。
tif-alpha
带有Alpha通道的TIFF。
tif
TIFF。
webp-alpha
带有Alpha通道的有损无损WebP。
webp
有损无损WebP。

pixelType - rgb |灰色| cmyk

pixelType
说明
cmyk
返回CMYK图像数据。
gray
返回灰度图像数据。
rgb
返回RGB图像数据。

compression - jpeg |有损|无损| lzw |无| zip

compression
说明
jpeg
JPEG压缩（有损）。
lossy
JPEG 2000、JPEG XR压缩（有损）和WebP。
lossless
HEIC、JPEG 2000、JPEG XR压缩（无损）和WebP。
lzw
LZW (Lempel-Ziv-Welch)压缩（无损）。
none
未压缩。
zip
“Deflate”压缩（无损）。

  • format​为发送到客户端的图像数据指定图像编码格式，并为HTTP响应标头指定相应的响应MIME类型。

  • 如果未指定​pixelType，则可使用icc=实现输出色彩空间转换。

    应用与​ pixelType ​对应的默认颜色配置文件。 如果禁用颜色管理，则应用朴素转换。 在指定​ pixelType ​时忽略icc=，这决定了输出像素类型。

  • 仅当将​compression、tif、tif-alpha、pdf、webp、webp-alpha、jpeg2000、jpeg2000-alpha或jpegxr指定为jpegxr-alpha时才允许​format。 有关这些图像格式支持的压缩选项，请参阅下表。

您可以使用qlt=为以下格式设置JPEG编码选项：JPEG、带有JPEG压缩的TIFF、带有JPEG压缩的PDF以及SWF。 WebP、JPEG 2000和JPEG XR也使用qlt=，但值导致不同格式具有不同的品质。 如果quantize=或fmt=gif，则使用fmt=gif-alpha。 有关详细信息，请参阅命令说明。 其他格式没有可设置的选项。

对于所有​ formats ​和​ pixelTypes ​返回8位/像素组件（对于GIF，每像素8位/像素）。

下表列出了*format和​pixelType*​的有效组合、相应的HTTP响应MIME类型、是否可以嵌入ICC配置文件（请参阅iccEmbed=）以及可以应用的特定于格式的选项。

格式
pixelType
响应MIME类型
嵌入ICC配置文件
选项
avif，avif-alpha
rgb
<image/avif>
否

压缩 （有损，无损）

已为无损忽略 qlt= 。

由于没有使用WebP格式的色度缩减像素取样概念，因此如果您使用带有 qlt 的第二个值（例如， qlt=80,1 ），则会忽略第二个值( 1 )。

eps
rgb、灰度、cmyk
<image/eps>
是
pathEmbed=
gif， gif-alpha

rgb，灰度

数据在转换为灰色或rgb后转换为调色板。

<image/gif>
否
量化=
heic
rgb
<image/heic>
否
jpeg2000， jpeg2000-alpha
rgb，灰度
<image/jp2>
否

压缩 （有损，无损）

已为无损忽略 qlt= 。

由于没有使用WebP格式的色度缩减像素取样概念，因此如果您使用带有 qlt 的第二个值（例如， qlt=80,1 ），则会忽略第二个值( 1 )。

jpeg， jpg， pjpeg
rgb、灰度、cmyk
<image/jpeg>
是

pathEmbed= ， pscan= ， qlt= ， xmpEmbed=

pscan= 参数仅适用于pjpeg格式。

jpegxr， jpegxr-alpha
rgb
<image/vnd.ms-photo>
否

压缩 （有损，无损）

已为无损忽略 qlt= 。

由于没有使用WebP格式的色度缩减像素取样概念，因此如果您使用带有 qlt 的第二个值（例如， qlt=80,1 ），则会忽略第二个值( 1 )。

pdf
rgb、灰度、cmyk
<application/pdf>
是

压缩

( none|zip|jpeg )， qlt=

已忽略 qlt= ，除非 压缩 设置为 jpeg 。

png8， png8-alpha
rgb
<image/png>
是
png， png-alpha
rgb，灰度
<image/png>
是
swf，swf3， swf-alpha， swf-alpha3
rgb，灰度
<application/x-shockwave-flash>

否

注意：Adobe Flash Player会忽略嵌入的ICC配置文件。

qlt= ，属性：：TrustedDomains
tif， tif-alpha
rgb、灰度、cmyk
<image/tiff>
是

压缩

( none|lzw|zip|jpeg )

仅限“tiff”；“tiff-alpha”不支持jpeg压缩。

qlt=

已忽略 qlt= ，除非压缩设置为 jpeg 。

， pathEmbed=， xmpEmbed=

webp， webp-alpha
rgb
<image/webp>
否

压缩 （有损，无损）

已为无损忽略 qlt= 。

由于没有使用WebP格式的色度缩减像素取样概念，因此如果您使用带有 qlt 的第二个值（例如， qlt=80,1 ），则会忽略第二个值( 1 )。

属性 section-5f96b0ce7c5a4df1bf52e24ea78c3dae

请求属性。 如果req=img（默认）或req=mask为适用对象，而不考虑当前图层设置；否则将忽略。

如果指定了​type，则忽略iccProfile=。

默认 section-f885a785b32c44fea347db15fdb2ab1f

fmt=jpeg, *defaultType*,none，其中​ defaultType ​按如下方式处理：如果指定了icc=，则​ defaultType ​对应于指定ICC配置文件的像素类型。 如果未指定icc=，如果​defaultType，gray为req=mask，否则为rgb。

示例 section-b93222e652df404a84c69025247f07df

请求一个JPEG格式的低质量小预览图像（默认）：

http:// *服务器*/myRootId/myImageId?qlt=60&wid=200

请求将同一图像转换为灰度：

http:// *服务器*/myRootId/myImageId?fmt=jpeg,gray&qlt=60&wid=200

以Alpha通道的无损失格式和高分辨率请求相同的图像：

http:// *服务器*/myRootId/myImageId?fmt=png-alpha&wid=300

为灰度为TIFF图像的同一图像请求Alpha通道：

http:// *服务器*/myRootId/myImageId?req=mask&fmt=tif,gray&wid=300

使用默认ICC配置文件将同一图像转换为cmyk：

http:// *服务器*/myRootId/myImageId?fmt=tif,cmyk&wid=300

使用其他ICC配置文件将同一图像转换为cmyk，并将配置文件嵌入到TIFF图像：

http:// *服务器*/myRootId/myImageId?fmt=tif&wid=300&icc=myPrinterProfile&iccEmbed=1

以JPEG压缩的TIF文件形式传递此图像，而不进行像素类型转换：

http:// *服务器*/myRootId/myImageId?fmt=tif,,jpeg&qlt=95&wid=300

将图像转换为具有关键颜色透明度的双调GIF并强制将颜色转换为黑白：

http:// *服务器*/myRootId/myImageId?fmt=gif-alpha&wid=100&quantize=adaptive,off,2,000000,ffffff

质量设置为80的​有损：

http:// *服务器*/myRootId/myImageId?wid=300&fmt=webp&qlt=80

带有Alpha的​无损：

http:// *服务器*/myRootId/myImageId?wid=300&fmt=webp-alpha,,lossless

质量设置为80的​有损：

http://server/myRootId/myImageId?wid=300&fmt=jpeg2000&qlt=80

带有Alpha的​无损：

http://server/myRootId/myImageId?wid=300&fmt=jpeg2000-alpha,,lossless

质量设置为80的​有损：

http://server/myRootId/myImageId?wid=300&fmt=jpegxr&qlt=80

带有Alpha的​无损：

http://server/myRootId/myImageId?wid=300&fmt=jpegxr-alpha,,lossless

另请参阅 section-fce8d69c74234bf48cf814d799409541

qlt= ，quantize=，req=，icc=，iccEmbed=，pathEmbed=，pscan。

recommendation-more-help
a26166cd-f2f4-45ce-996d-96a0f0d6cf49