---
url: "/es/tinyimage/automation/parameters.md"
description: "Ejecuta las Quick Actions de TinyImage con campos sencillos con nombre y atajos que usan la selección actual."
---

# Quick Actions de TinyImage

> Ejecuta las Quick Actions de TinyImage con campos sencillos con nombre y atajos que usan la selección actual.

Ejecuta las tareas habituales de TinyImage desde las Quick Actions de Figma sin abrir el panel del plugin. Elige uno de los atajos con nombre que aparecen abajo. Usa el panel normal del plugin para los ajustes detallados y la creación de contenido.

## Ejecutar una Quick Action {#run-a-quick-action}

Los controles de Figma Motion que solo están en el panel abierto no se conservan entre ejecuciones; esos controles usan los campos explícitos del atajo o las alternativas documentadas.

Todos los atajos requieren una licencia válida verificada o usos de prueba restantes. Si la verificación falla o se te han acabado los usos de prueba, abre el panel normal del plugin para activar tu licencia. El panel siempre se puede abrir.

1. Selecciona las capas con las que quieres trabajar, si el atajo usa una selección.
2. Abre las Quick Actions de Figma con **Command + /** en Mac o **Ctrl + /** en Windows.
3. Busca el plugin y elige el atajo con nombre que aparece abajo.
4. Rellena los campos que se muestran. Puedes saltarte los campos opcionales; usa el tabulador para editarlos. Ejecuta el atajo y comprueba el resultado o completa su cuadro de diálogo para guardar.

Los atajos de creación te piden nombres o dimensiones directamente. Los atajos de capas seleccionadas usan automáticamente la selección actual. Estos atajos del día a día no piden Target ni JSON. Elige **Open TinyImage** para abrir el panel normal del plugin.

| Atajo | Campos |
| --- | --- |
| **Compress Selected Layers (Custom Settings…)** | Calidad (1–100) (opcional) |
| **Convert Selected Layers (Custom Settings…)** | Formato de conversión, Calidad (1–100) (opcional) |
| **Export Selected Layers as PDF** | Ninguno; se ejecuta al instante |
| **Export Selected Figma Motion (Custom Settings…)** | Formato (opcional), Fotogramas por segundo (opcional) |
| **Arrange Selected Layers (Custom Settings…)** | Disposición (opcional), Separación horizontal (px) (opcional), Separación vertical (px) (opcional) |

Los campos de opciones fijas usan etiquetas legibles. Busca por la etiqueta que se muestra o por el valor subyacente; los campos para agentes siguen usando los valores que aparecen en la referencia de comandos.

## Ejecutar desde el menú contextual {#run-from-the-context-menu}

Selecciona las capas que quieras, haz clic derecho y elige **Plugins → TinyImage** (los plugins en desarrollo aparecen en **Development**). Elige una acción y su formato o preajuste. Un preajuste se ejecuta al instante cuando no necesita ningún campo obligatorio; completa el cuadro de diálogo para guardar cuando aparezca.

Cada preajuste define la opción que indica su nombre. Las opciones compatibles que no indiques heredan los ajustes guardados del plugin; una acción u opción explícita tiene prioridad sobre el comportamiento guardado que entre en conflicto. Solo los campos que introduzcas explícitamente o la opción del menú que elijas los sustituyen en esa ejecución. Si un ajuste nunca se ha guardado, se aplica el ajuste normal o la alternativa documentada. Los cambios de exportación no se guardan en tus preferencias. Si un formato guardado no está disponible como atajo, elige explícitamente un formato compatible o usa el panel normal. Para combinar opciones, elige **Custom Settings…** dentro de la acción e introduce los parámetros. Las acciones que necesitan texto, URL, nombres o dimensiones siguen pidiendo esos campos obligatorios. **Open TinyImage** abre el panel normal.

**Compress Selected Layers** siempre mantiene los formatos de exportación originales, aunque la conversión esté guardada en el panel normal. Usa **Convert Selected Layers** para elegir WebP, AVIF o Tiny SVG. La conversión requiere un formato explícito; la calidad que no indiques y las demás preferencias de compresión siguen heredando los ajustes guardados. Una calidad explícita desactiva en esa ejecución los modos guardados sin pérdida y de peso objetivo; quien haga llamadas avanzadas puede activar esos modos de forma explícita. Los atajos de exportación nunca reducen los rellenos de imagen de tus capas de origen de Figma. **Arrange Selected Layers** siempre organiza las capas y solo hereda la disposición y la separación. No cambia nombres, no ordena, no envuelve instancias ni actualiza el texto de la paginación; si lo necesitas, pide esas operaciones de forma explícita con las opciones avanzadas. Crea los lienzos de impresión y ajusta la configuración de impresión en el panel normal. La frecuencia de fotogramas de Motion sigue disponible en Custom Settings.

| Opción del menú | Siguiente paso |
| --- | --- |
| **Compress Selected Layers → Use Saved Settings** | Se ejecuta al instante |
| **Compress Selected Layers → Compress Selected Layers (Custom Settings…)** | Introduce Calidad (1–100) (opcional) |
| **Convert Selected Layers → JPG and PNG to WebP** | Se ejecuta al instante |
| **Convert Selected Layers → Only JPG to WebP** | Se ejecuta al instante |
| **Convert Selected Layers → Only PNG to WebP** | Se ejecuta al instante |
| **Convert Selected Layers → JPG and PNG to AVIF** | Se ejecuta al instante |
| **Convert Selected Layers → SVG to Tiny 1.2 SVG** | Se ejecuta al instante |
| **Convert Selected Layers → Convert Selected Layers (Custom Settings…)** | Introduce Formato de conversión y Calidad (1–100) (opcional) |
| **Export Selected Layers as PDF** | Se ejecuta al instante |
| **Export Selected Figma Motion → Use Default Settings** | Se ejecuta al instante |
| **Export Selected Figma Motion → Animated GIF** | Se ejecuta al instante |
| **Export Selected Figma Motion → MP4 Video** | Se ejecuta al instante |
| **Export Selected Figma Motion → WebM Video** | Se ejecuta al instante |
| **Export Selected Figma Motion → Export Selected Figma Motion (Custom Settings…)** | Introduce Formato (opcional) y Fotogramas por segundo (opcional) |
| **Arrange Selected Layers → Use Saved Layout and Spacing** | Se ejecuta al instante |
| **Arrange Selected Layers → Automatic** | Se ejecuta al instante |
| **Arrange Selected Layers → Rows** | Se ejecuta al instante |
| **Arrange Selected Layers → Columns** | Se ejecuta al instante |
| **Arrange Selected Layers → Arrange Selected Layers (Custom Settings…)** | Introduce Disposición (opcional), Separación horizontal (px) (opcional) y Separación vertical (px) (opcional) |

## Edición detallada {#detailed-editing}

Usa el panel normal del plugin para los ajustes detallados, el contenido más largo, la creación en bloque y para explorar componentes o plantillas. El menú de atajos solo contiene los comandos del día a día que aparecen arriba.

Mantén cada campo pegado por debajo de 150 caracteres: la app de escritorio de Figma puede cortar el texto pegado a partir de ese límite. Los textos más largos van en el panel normal.

Si un plugin antiguo muestra Action, Target y Options en su lugar, actualízalo para usar estos atajos con nombre. Un valor de Target es un ID de capa o una selección, nunca el nombre de un elemento nuevo.

## Acciones de TinyImage {#tinyimage-actions}

| Acción | Qué hace | Target |
| --- | --- | --- |
| [`compress`](#compress) | Comprime las capas seleccionadas sin cambiar sus formatos de exportación de Figma | Una o más capas válidas |
| [`pdf`](#pdf) | Combina los frames seleccionados en un PDF para pantalla | Una o más capas válidas |
| [`motion`](#motion) | Exporta Figma Motion nativo a partir de un único origen | Exactamente una capa válida |
| [`convert`](#convert) | Convierte las capas seleccionadas a un formato de salida elegido de forma explícita | Una o más capas válidas |
| [`tidy`](#tidy) | Organiza capas hermanas indicadas de forma explícita; ordenar, envolver, cambiar nombres y actualizar la paginación requieren opciones explícitas | Una o más capas válidas |

### compress {#compress}

Comprime las capas seleccionadas sin cambiar sus formatos de exportación de Figma. Selecciona una o más capas válidas.

| Opción | Tipo | Obligatorio / valor por defecto | Significado y valores aceptados |
| --- | --- | --- | --- |
| `quality` | number | Alternativa: `90` | Calidad de compresión. Mínimo 1; máximo 100 |

Los campos obligatorios anidados se aplican cuando se incluye su objeto padre o el elemento de la matriz. Los valores opcionales que no indiques usan el comportamiento de la operación existente, salvo que se indique un valor por defecto.

Elige **Compress Selected Layers (Custom Settings…)**. Introduce estos campos sencillos; no hace falta JSON:

- **Quality (1–100)**: `90`

Entrada del host del agente

```json
{"command":"shortcut-compress","parameters":{"quality":"90"}}
```

### pdf {#pdf}

Combina los frames seleccionados en un PDF para pantalla. Selecciona una o más capas válidas.

Este atajo no tiene campos.

Elige **Export Selected Layers as PDF**. Se ejecuta al instante con la selección actual.

Entrada del host del agente

```json
{"command":"shortcut-pdf","parameters":{}}
```

### motion {#motion}

Exporta Figma Motion nativo a partir de un único origen. Selecciona exactamente una capa válida.

| Opción | Tipo | Obligatorio / valor por defecto | Significado y valores aceptados |
| --- | --- | --- | --- |
| `format` | string | Alternativa: `"GIF"` | Formato de la animación. `GIF`, `MP4`, `WEBM` |
| `fps` | number | Alternativa: `30` | Fotogramas por segundo; se siguen aplicando las restricciones del plan nativo. `10`, `15`, `24`, `25`, `30`, `60` |

Los campos obligatorios anidados se aplican cuando se incluye su objeto padre o el elemento de la matriz. Los valores opcionales que no indiques usan el comportamiento de la operación existente, salvo que se indique un valor por defecto.

Elige **Export Selected Figma Motion (Custom Settings…)**. Introduce estos campos sencillos; no hace falta JSON:

- **Format**: **Animated GIF**
- **Frames per second**: **30 fps**

Entrada del host del agente

```json
{"command":"shortcut-motion","parameters":{"format":"GIF","fps":"30"}}
```

### convert {#convert}

Convierte las capas seleccionadas a un formato de salida elegido de forma explícita. Selecciona una o más capas válidas.

| Opción | Tipo | Obligatorio / valor por defecto | Significado y valores aceptados |
| --- | --- | --- | --- |
| `convert` | string | Obligatorio | Conversión de salida; usa compress para mantener los formatos originales. `webp`, `webpjpg`, `webppng`, `avif`, `tinysvg` |
| `quality` | number | Alternativa: `90` | Calidad de compresión. Mínimo 1; máximo 100 |

Los campos obligatorios anidados se aplican cuando se incluye su objeto padre o el elemento de la matriz. Los valores opcionales que no indiques usan el comportamiento de la operación existente, salvo que se indique un valor por defecto.

Elige **Convert Selected Layers (Custom Settings…)**. Introduce estos campos sencillos; no hace falta JSON:

- **Convert format**: **JPG and PNG to WebP**
- **Quality (1–100)**: `90`

Entrada del host del agente

```json
{"command":"shortcut-convert","parameters":{"convert":"webp","quality":"90"}}
```

### tidy {#tidy}

Organiza capas hermanas indicadas de forma explícita; ordenar, envolver, cambiar nombres y actualizar la paginación requieren opciones explícitas. Selecciona una o más capas válidas.

| Opción | Tipo | Obligatorio / valor por defecto | Significado y valores aceptados |
| --- | --- | --- | --- |
| `layout` | string | Alternativa: `"auto"` | Dirección de la disposición. `auto`, `rows`, `columns` |
| `horizontalSpacing` | number | Alternativa: `100` | Separación horizontal en píxeles. Mínimo 0; máximo 10000 |
| `verticalSpacing` | number | Alternativa: `100` | Separación vertical en píxeles. Mínimo 0; máximo 10000 |

Los campos obligatorios anidados se aplican cuando se incluye su objeto padre o el elemento de la matriz. Los valores opcionales que no indiques usan el comportamiento de la operación existente, salvo que se indique un valor por defecto.

Elige **Arrange Selected Layers (Custom Settings…)**. Introduce estos campos sencillos; no hace falta JSON:

- **Layout**: **Automatic**
- **Horizontal gap (px)**: `100`
- **Vertical gap (px)**: `100`

Entrada del host del agente

```json
{"command":"shortcut-tidy","parameters":{"layout":"auto","horizontalSpacing":"100","verticalSpacing":"100"}}
```

## Usar los atajos con un agente {#using-shortcuts-with-an-agent}

Lee el registro legible por máquina enlazado abajo y elige una acción que ofrezca la lista de Quick Actions del plugin instalado. El registro usa definiciones de opciones de Hypermatic en lugar del JSON Schema estándar: `min` y `max` limitan la longitud de la cadena, la longitud de la matriz o el valor numérico según el tipo de campo; las definiciones anidadas usan `fields` e `item`. Los campos desconocidos se rechazan.

El agente necesita un host que pueda invocar las Quick Actions de Figma y observar el resultado normal del plugin. Los parámetros no añaden ningún lanzador REST ni MCP. Los ejemplos desplegables son datos de entrada para un host compatible, no llamadas a una API ejecutables; los campos de los atajos usan cadenas sencillas en `parameters`, incluidos los números y las opciones de formato. Nunca afirmes que un atajo se ha ejecutado solo porque tienes preparada su entrada.

Verifica el resultado visible: las capas de Figma modificadas, la exportación guardada o la página publicada. Lee la notificación normal de éxito o error y cualquier aviso de exportación parcial. Completa los cuadros de diálogo nativos para guardar cuando haga falta; que empiece una descarga no demuestra que el archivo se haya guardado. Los usuarios no necesitan abrir las herramientas de desarrollo ni leer una consola.

## Solución de problemas {#troubleshooting}

| Síntoma | Siguiente paso |
| --- | --- |
| La acción no está disponible | Actualiza el plugin y revisa su lista de Quick Actions; usa el panel normal si la acción no está disponible. |
| Las opciones no son válidas o pueden haberse cortado | Usa valores de campo sencillos e individuales de menos de 150 caracteres, solo con los campos que acepta ese atajo. |
| Falta el Target o no es válido | Abre la página correcta, revisa los requisitos de capas de la acción y vuelve a seleccionar las capas que quieras. |
| Aparece un error de licencia o de prueba | Completa el proceso de activación normal del plugin antes de volver a ejecutarlo. |
| Se pidió una descarga, pero no ves ningún archivo guardado | Revisa el cuadro de diálogo nativo para guardar y la ubicación de descarga. Comprueba el archivo real. |
| Un comando falla, se agota el tiempo o se cancela | Revisa el documento y el destino remoto antes de reintentarlo; puede que ya existan cambios o subidas anteriores. |

Los comandos tienen un plazo de cinco minutos. Los errores no implican que se deshaga todo. Reintentar automáticamente una creación, una sustitución o una subida puede duplicar o sobrescribir el trabajo.

El [registro de comandos legible por máquina](/automation/parameters/tinyimage.json) contiene los mismos ID de acción y definiciones de opciones.

## Límites actuales {#current-limits}

La compresión usa los formatos de exportación de Figma de las capas seleccionadas; la conversión requiere elegir un formato. Los atajos de exportación no reducen los rellenos de imagen de origen. Motion acepta un solo origen; define la frecuencia de fotogramas en Custom Settings. Arrange solo cambia la disposición y la separación. Los lienzos de impresión, los lienzos de logotipos, el montaje de vídeos en bloque y los controles detallados de Tidy se usan desde el panel normal.

## Documentación relacionada {#related-documentation}

- [Instalar y ejecutar TinyImage](/es/tinyimage/overview/install)
- [Parámetros de plugins de Figma](https://developers.figma.com/docs/plugins/plugin-parameters/)
- [Opciones de interfaz oculta de Figma](https://developers.figma.com/docs/plugins/api/properties/figma-showui/)