> ## Documentation Index
> Fetch the complete documentation index at: https://glasser.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# glasser run

> Ejecuta un Endpoint y recupera su salida.

## Uso

```bash theme={null}
glasser run -p <provider> -e <endpoint> [-i '<json>' | -f <file>]
```

Ejecuta un endpoint y paga esa única llamada. La clave de idempotencia se genera y se muestra si se omite; si reintentas un fallo ambiguo con la misma clave, obtendrás el Run original en lugar de un segundo cobro.

## Opciones

| Opción | Descripción |
| - | - |
| `--provider, -p` | Identificador del proveedor (p. ej., pdl) |
| `--endpoint, -e` | Clave del endpoint (p. ej., /v5/person/enrich) |
| `--input, -i` | Entrada nativa del proveedor: JSON insertado o @path/to/file.json |
| `--input-file, -f` | Lee la entrada de un archivo JSON (alternativa a -i @file) |
| `--endpoint-version` | Selecciona una versión de Endpoint compatible (no fija Price; devuelve 409 si no está disponible o se ha retirado) |
| `--idempotency-key` | Reutiliza una clave para reintentar de forma segura; se genera (y se muestra) si se omite |
| `--task` | Asocia este Run al `task_id` de una respuesta de búsqueda |
| `--wait, -w` | Consulta hasta que el Run alcance un estado terminal |
| `--wait-timeout` | Segundos que se esperarán antes de abandonar (valor predeterminado: 300; requiere --wait) |
| `--output, -o` | Escribe el campo de salida del Run en un archivo (solo COMPLETED con salida) |

## Esperar un resultado

Sin `--wait`, un Endpoint asíncrono puede devolver un Run `QUEUED` o `RUNNING`.
Usa `--wait` para consultar hasta obtener un estado terminal. `--wait-timeout` debe ser un
entero positivo en segundos y su valor predeterminado es `300`.

Un tiempo de espera agotado termina con el código `1`; no detiene el Run. Reanuda la espera
con `glasser runs get -r <runId> --wait`. Comprueba `status`,
`provider_response.http_status` y `charge_usd` por separado.

Pasa `--task` para mantener el Run junto con su búsqueda e inspección. Consulta
[Cómo mantener las llamadas en un Task](https://glasser.ai/docs/es/cli.md#keep-calls-in-one-task).

Consulta [Convenciones de la CLI](https://glasser.ai/docs/es/cli.md#global-flags) para obtener información sobre las opciones globales, el modo JSON, los códigos de salida y las variables de entorno.

## Errores del proveedor

En caso de un error del proveedor, la CLI muestra su estado HTTP y el cuerpo del error. Con
`--json`, lee `provider_response.http_status` y `provider_response.error`
en el Run devuelto. Un estado `COMPLETED` por sí solo no significa que el proveedor
haya aceptado la solicitud. Consulta [Gestión de la respuesta de Run](https://glasser.ai/docs/es/api-reference/overview.md#read-the-result).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.