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

# Como funciona

> Como o Glasser recupera dados, cobra por Runs e controla o acesso.

As mesmas regras se aplicam independentemente de você usar o Glasser por meio de um Agent, MCP, CLI ou HTTP.

## Da solicitação aos dados

O Glasser conecta você a dados pagos de **Providers** especializados. Um **Endpoint**
é uma operação de um Provider, com seu próprio esquema de entrada, versão e Price.
Sua Glasser Key dá acesso sem contas separadas dos Providers.

1. **Pesquise** um Endpoint adequado à sua solicitação.
2. **Inspecione** seu esquema de entrada e o Price atual.
3. **Execute**-o para recuperar dados. O Glasser registra o resultado e a cobrança em um **Run**.

Search e Inspect são gratuitos. Para tarefas predefinidas,
[Solutions](https://glasser.ai/docs/pt/api-reference/solutions/overview.md) podem selecionar um Endpoint e mapear
sua entrada para você. Ambos os caminhos usam os mesmos Runs e o saldo do Workspace.

## Entenda o Price

Inspect mostra como um Endpoint cobra:

* **Resultado bem-sucedido:** um valor fixo ou um valor medido (como por resultado ou token), com um limite máximo.
* **Outros resultados:** regras separadas para nenhum resultado, erros do Provider, timeouts
  e falhas internas (`NO_RESULT`, `PROVIDER_ERROR`, `TIMED_OUT`, `INTERNAL`).

Um novo Run usa o Price vigente na admissão e o mantém até a liquidação. A versão de um
Endpoint não fixa o Price para Runs futuros.

Os valores são strings decimais exatas em USD, como `"0.005"`. Use aritmética decimal,
não aritmética de ponto flutuante, ao somá-los.

## Status do Run

Antes de criar um Run, o Glasser verifica o acesso e os fundos disponíveis e faz um
**Hold** da cobrança máxima. Uma solicitação recusada não cria Run nem cobrança.
Quando o Run termina, o Glasser encerra o Hold e registra a cobrança final.

| Status | Significado |
| - | - |
| `QUEUED` | Aceito e aguardando despacho. |
| `RUNNING` | Execução em andamento. |
| `COMPLETED` | Concluído com uma resposta do Provider, que pode incluir um erro. |
| `FAILED` | Concluído sem uma resposta utilizável do Provider. Leia `failure` para saber o motivo. |
| `STOPPED` | Interrompido antes do despacho, sem cobrança. |

Uma solicitação de interrupção após o despacho não cancela o trabalho do Provider. Leia o
status retornado e a cobrança final; consulte [Interromper um Run](https://glasser.ai/docs/pt/api-reference/runs/stop.md).

## Leia o resultado e a cobrança

Verifique estes campos separadamente:

| Campo | O que informa |
| - | - |
| `status` | Se o Run ainda está em andamento ou foi concluído. |
| `provider_response` | Se o Provider retornou dados ou um erro. Um 404 ou 500 do Provider pode ser um Run `COMPLETED`. |
| `charge_usd` | Quanto o Run cobrou. Um Run `FAILED` ainda pode ter uma cobrança dentro do seu Price. |

## Tente novamente sem uma segunda cobrança

Após um timeout ou perda de conexão, tente novamente com a **mesma chave de idempotência**
para recuperar o Run original sem iniciar outro nem ser cobrado por ele.

* Mantenha `provider`, `endpoint`, `input` e `endpoint_version` iguais.
* Alterar esses parâmetros de execução usando a mesma chave retorna um conflito.
* Use uma chave nova somente quando quiser iniciar outro Run.

Alterar `task_id` ou `metadata` não cria um novo Run nem atualiza o Run original.
As respostas do MCP também incluem `replayed: true` para uma nova tentativa; as respostas da
API HTTP e do CLI retornam o Run sem esse campo.

## Keys e políticas

Uma **Key** pertence a um **Workspace**. Os Runs usam o saldo desse Workspace.

Um Endpoint precisa ser permitido tanto pela Policy do Workspace quanto pela Policy da Key.
Search omite Endpoints que não fazem parte desse acesso; Inspect retorna não encontrado para eles.

## Adicionar fundos

Adicione fundos na [página de saldo](https://app.glasser.ai/balance?utm_source=docs\&utm_medium=how-it-works).
A API, o CLI e o MCP não podem adicionar fundos.

| Forma | O que é necessário |
| - | - |
| Recarga | Pague com cartão. A recarga automática pode repetir o pagamento. |
| Indicação | Compartilhe seu link de indicação. Ambos os Workspaces recebem um Grant no cadastro; você recebe outro quando o novo usuário faz uma recarga e executa algo. |
| Compartilhar um Run | Compartilhe um Run `COMPLETED` no X ou no LinkedIn e envie o link da publicação para reivindicar um Grant. Requer uma recarga anterior. |

Um Grant é saldo gratuito: não expira e é usado como qualquer outro saldo. Todo novo
Workspace começa com um Grant de cadastro. Grants de indicação e compartilhamento têm
limites vitalícios por Workspace; o console mostra os valores e limites atuais. Grants
aparecem no histórico do saldo com o tipo `grant`.

## Um modelo, quatro superfícies

As mesmas regras de execução, cobrança e políticas se aplicam à [API HTTP](https://glasser.ai/docs/pt/api-reference/endpoints/search.md),
ao [CLI](https://glasser.ai/docs/pt/cli.md), ao [servidor MCP](https://glasser.ai/docs/pt/mcp-server.md) e ao Skill do agent.


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