> ## 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

> Execute um Endpoint e recupere sua saída.

## Uso

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

Execute um endpoint e pague por essa única chamada. A chave de idempotência é gerada e exibida quando omitida — repita uma falha ambígua com a mesma chave para obter o Run original em vez de gerar uma segunda cobrança.

## Opções

| Opção | Descrição |
| - | - |
| `--provider, -p` | Slug do provedor de dados (por exemplo, pdl) |
| `--endpoint, -e` | Chave do endpoint (por exemplo, /v5/person/enrich) |
| `--input, -i` | Entrada nativa do provedor de dados: JSON embutido ou @path/to/file.json |
| `--input-file, -f` | Leia a entrada de um arquivo JSON (alternativa a -i @file) |
| `--endpoint-version` | Selecione uma versão compatível do Endpoint (não fixa o Price; 409 se estiver indisponível ou aposentada) |
| `--idempotency-key` | Reutilize uma chave para repetir com segurança; gerada (e exibida) quando omitida |
| `--task` | Associe este Run ao `task_id` de uma resposta de pesquisa |
| `--wait, -w` | Consulte até o Run chegar a um estado terminal |
| `--wait-timeout` | Segundos a aguardar antes de desistir (padrão 300; requer --wait) |
| `--output, -o` | Grave o campo de saída do Run em um arquivo (somente COMPLETED com saída) |

## Aguardar um resultado

Sem `--wait`, um Endpoint assíncrono pode retornar um Run `QUEUED` ou `RUNNING`.
Use `--wait` para consultar até obter um status terminal. `--wait-timeout` deve ser um
inteiro positivo em segundos e o padrão é `300`.

Um timeout de espera encerra com o código `1`; ele não interrompe o Run. Retome a espera
com `glasser runs get -r <runId> --wait`. Verifique `status`,
`provider_response.http_status` e `charge_usd` separadamente.

Passe `--task` para manter o Run associado à pesquisa e à inspeção. Consulte
[como manter chamadas em um único Task](https://glasser.ai/docs/pt/cli.md#keep-calls-in-one-task).

Consulte [convenções da CLI](https://glasser.ai/docs/pt/cli.md#global-flags) para ver opções globais, modo JSON, códigos de saída e variáveis de ambiente.

## Erros do provedor de dados

Para um erro do provedor de dados, a CLI exibe o status HTTP e o corpo do erro. Com
`--json`, leia `provider_response.http_status` e `provider_response.error`
no Run retornado. Um status `COMPLETED` isolado não significa que o provedor de dados
aceitou a solicitação. Consulte [tratamento da resposta do Run](https://glasser.ai/docs/pt/api-reference/overview.md#read-the-result).


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