DocumentaciónAPI de servicio y procesamiento de imágenes de Dynamic Media

fmt fmt

Last update: Fri Aug 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Desarrollador
  • Usuario

Formato de imagen de respuesta.

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

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

format
Descripción
avif-alpha
AVIF con pérdida y sin pérdida con canal alfa.
avif
AVIF con pérdidas y sin pérdidas.
eps
PostScript encapsulado binario sin comprimir.
f4m
Formato de manifiesto de Flash Streaming Server.
gif-alpha
GIF con 2 a 255 colores más transparencia key-color.
gif
GIF con 2 a 256 colores.
heic
HEIC sin pérdidas. Este formato se descarga de forma predeterminada desde el explorador si no es compatible.
jpeg
JPEG con pérdida.
jpeg2000-alpha
JPEG 2000 sin pérdidas ni pérdidas con canal alfa.
jpeg2000
JPEG 2000 sin pérdidas ni pérdidas.
jpegxr-alpha
JPEG XR sin pérdidas y con canal alfa.
jpegxr
JPEG XR con pérdidas y sin pérdidas.
jpg
JPG con pérdida.
m3u8
Formato de manifiesto del servidor de flujo Apple.
pdf
Imagen incrustada en PDF.
pjpeg
Progressive JPEG.
png-alpha
PNG sin pérdidas de 24 bits con canal alfa.
png
PNG sin pérdidas de 24 bits.
png8-alpha
PNG sin pérdidas de 8 bits con canal alfa.
png8
PNG sin pérdidas de 8 bits.
swf-alpha
Lossy JPEG y una máscara comprimida de desinflado incrustada en un archivo swf AS2 de Adobe.
swf
JPEG con pérdida incrustado en un archivo swf de Adobe AS2.
swf3-alpha
Lossy JPEG y una máscara comprimida de desinflado incrustada en un archivo swf de Adobe AS3. Nota: los formatos swf y swf-alpha se usan mejor para las aplicaciones ActionScript 2 (Flash Player 8 y versiones anteriores). Se recomienda utilizar los formatos swf3 y swf3-alpha para las aplicaciones ActionScript3 (Flash Player 9 y posterior).
swf3
JPEG con pérdida incrustado en un archivo swf de Adobe AS3.
tif-alpha
TIFF con canal alfa.
tif
TIFF.
webp-alpha
WebP sin pérdidas y con canal alfa.
webp
WebP con pérdidas y sin pérdidas.

pixelType - rgb | gris | cmyk

pixelType
Descripción
cmyk
Devuelve datos de imagen CMYK.
gray
Devuelve datos de imagen en escala de grises.
rgb
Devolver datos de imagen de RGB.

compression - jpeg | con pérdidas | sin pérdidas | lzw | ninguno | zip

compression
Descripción
jpeg
Compresión de JPEG (con pérdida).
lossy
JPEG 2000 y compresión JPEG XR (con pérdida) y WebP.
lossless
HEIC, JPEG 2000, compresión JPEG XR (sin pérdidas) y WebP.
lzw
Compresión LZW (Lempel-Ziv-Welch) (sin pérdidas).
none
Sin comprimir.
zip
Compresión "Deflate" (sin pérdidas).

  • format especifica el formato de codificación de imagen para los datos de imagen enviados al cliente y el tipo MIME de respuesta correspondiente para el encabezado de respuesta HTTP.

  • pixelType se puede usar para efectuar la conversión del espacio de color de salida cuando icc= no se especifica.

    Se aplica el perfil de color predeterminado correspondiente a pixelType. Si la gestión de colores está desactivada, se aplica una conversión naïve. pixelType se omite cuando se especifica icc=, lo que determina el tipo de píxel de salida.

  • compression solo se permite si tif, tif-alpha, pdf, webp, webp-alpha, jpeg2000, jpeg2000-alpha, jpegxr o jpegxr-alpha se especifica como format. Consulte la tabla siguiente para ver las opciones de compresión admitidas para estos formatos de imagen.

Puede usar qlt= para establecer las opciones de codificación de JPEG para estos formatos: JPEG, TIFF con compresión JPEG, PDF con compresión JPEG y SWF. WebP, JPEG 2000 y JPEG XR también usan qlt=, pero los valores dan como resultado calidades diferentes para los distintos formatos. Use quantize= si fmt=gif o fmt=gif-alpha. Consulte las descripciones de los comandos para obtener más información. Los demás formatos no tienen opciones configurables.

Se devuelven 8 bits por componente de píxel para todos los formats y pixelTypes (8 bits por píxel para GIF).

En la tabla siguiente se enumeran las combinaciones válidas de *format*y pixelType, los tipos MIME de respuesta HTTP correspondientes, si los perfiles ICC se pueden incrustar (consulte iccEmbed=) y qué opciones específicas de formato se pueden aplicar.

formato
pixelType
tipo MIME de respuesta
Incrustar perfil ICC
opciones
avif, avif-alfa
rgb
<image/avif>
No

compresión ( con pérdida , sin pérdida )

qlt= se omite para sin pérdidas .

Dado que no existe ningún concepto de disminución de resolución de crominancia con el formato WebP, si utiliza un segundo valor con qlt (por ejemplo, qlt=80,1 ), se omitirá el segundo valor ( 1 ).

eps
rgb, gris, cmyk
<image/eps>
Sí
pathEmbed=
gif, gif-alpha

rgb, gris

Los datos se convierten a la paleta después de la conversión a gris o rgb.

<image/gif>
No
cuantizar=
héico
rgb
<image/heic>
No
jpeg2000, jpeg2000-alpha
rgb, gris
<image/jp2>
No

compresión ( con pérdida , sin pérdida )

qlt= se omite para sin pérdidas .

Dado que no existe ningún concepto de disminución de resolución de crominancia con el formato WebP, si utiliza un segundo valor con qlt (por ejemplo, qlt=80,1 ), se omitirá el segundo valor ( 1 ).

JPEG, JPG, JPEG
rgb, gris, cmyk
<image/jpeg>
Sí

pathEmbed= , pscan= , qlt= , xmpEmbed=

El parámetro pscan= solo se aplica al formato pjpeg.

jpegxr, jpegxr-alpha
rgb
<image/vnd.ms-photo>
No

compresión ( con pérdida , sin pérdida )

qlt= se omite para sin pérdidas .

Dado que no existe ningún concepto de disminución de resolución de crominancia con el formato WebP, si utiliza un segundo valor con qlt (por ejemplo, qlt=80,1 ), se omitirá el segundo valor ( 1 ).

pdf
rgb, gris, cmyk
<application/pdf>
Sí

compresión

( none|zip|jpeg ), qlt=

qlt= se omite a menos que la compresión se establezca en jpeg .

png8, png8-alpha
rgb
<image/png>
Sí
png, png-alfa
rgb, gris
<image/png>
Sí
swf,swf3, swf-alfa, swf-alfa3
rgb, gris
<application/x-shockwave-flash>

No

Nota: Adobe Flash Player ignora los perfiles ICC incrustados.

qlt= , atributo::TrustedDomains
tif, tif-alpha
rgb, gris, cmyk
<image/tiff>
Sí

compresión

( none|lzw|zip|jpeg )

solo 'tiff'; 'tiff-alpha' no admite la compresión jpeg.

qlt=

qlt= se omite a menos que la compresión se establezca en jpeg .

, pathEmbed=, xmpEmbed=

webp, webp-alpha
rgb
<image/webp>
No

compresión ( con pérdida , sin pérdida )

qlt= se omite para sin pérdidas .

Dado que no existe ningún concepto de disminución de resolución de crominancia con el formato WebP, si utiliza un segundo valor con qlt (por ejemplo, qlt=80,1 ), se omitirá el segundo valor ( 1 ).

Propiedades section-5f96b0ce7c5a4df1bf52e24ea78c3dae

Atributo de solicitud. Se aplica independientemente de la configuración de capa actual si req=img (predeterminado) o req=mask; se omite en caso contrario.

type se omite si se especifica iccProfile=.

Predeterminado section-f885a785b32c44fea347db15fdb2ab1f

fmt=jpeg, *defaultType*,none, donde defaultType se administra de la siguiente manera: Si se especifica icc=, defaultType corresponde al tipo de píxel del perfil ICC especificado. Si no se especifica icc=, defaultType es gray si req=mask; en caso contrario, es rgb.

Ejemplos section-b93222e652df404a84c69025247f07df

Solicitar una imagen de vista previa pequeña y de baja calidad en formato JPEG (predeterminado):

http:// *servidor*/myRootId/myImageId?qlt=60&wid=200

Solicitar la misma imagen convertida a escala de grises:

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

Solicite la misma imagen en un formato sin pérdidas con canal alfa y en alta resolución:

http:// *servidor*/myRootId/myImageId?fmt=png-alpha&wid=300

Solicite el canal alfa para la misma imagen que una imagen TIFF en escala de grises:

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

Convertir la misma imagen a cmyk con los perfiles ICC predeterminados:

http:// *servidor*/myRootId/myImageId?fmt=tif,cmyk&wid=300

Convierta la misma imagen a cmyk usando un perfil ICC diferente e incruste el perfil en la imagen de TIFF:

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

Enviar esta imagen como archivo TIF con compresión JPEG sin conversión de tipo de píxel:

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

Convertir la imagen a un GIF bitono con transparencia de clave de color y forzar los colores a blanco y negro:

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

Perdedor con una configuración de calidad de 80:

http:// *servidor*/myRootId/myImageId?wid=300&fmt=webp&qlt=80

Sin pérdidas con alfa:

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

Perdedor con una configuración de calidad de 80:

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

Sin pérdidas con alfa:

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

Perdedor con una configuración de calidad de 80:

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

Sin pérdidas con alfa:

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

Véase también section-fce8d69c74234bf48cf814d799409541

qlt= , Quantize=, req=, icc=, iccEmbed=, pathEmbed=, pscan.

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