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

# Cómo funciona

> Cómo Glasser recupera datos, cobra los Runs y controla el acceso.

Las mismas reglas se aplican tanto si usas Glasser mediante un Agent, MCP, la CLI o HTTP.

## De la solicitud a los datos

Glasser te conecta con datos de pago de proveedores de datos especializados. Un **Endpoint**
es una operación de un proveedor de datos, con su propio esquema de entrada, versión y Price.
Tu Glasser Key te da acceso sin necesidad de cuentas independientes de proveedores de datos.

1. **Busca** un Endpoint que se ajuste a tu solicitud.
2. **Inspecciona** su esquema de entrada y su Price actual.
3. **Ejecútalo** para recuperar datos. Glasser registra el resultado y el cargo en un **Run**.

Search e Inspect son gratuitos. Para tareas predefinidas,
[Solutions](https://glasser.ai/docs/es/api-reference/solutions/overview.md) puede seleccionar un Endpoint y asignar
tu entrada por ti. Ambas rutas usan los mismos Runs y el saldo del Workspace.

## Entender el Price

Inspect muestra cómo cobra un Endpoint:

* **Resultado correcto:** un importe fijo o un importe medido (por ejemplo, por resultado o token) con un límite máximo.
* **Otros resultados:** reglas independientes para ningún resultado, errores del proveedor de datos, tiempos de espera agotados y errores internos (`NO_RESULT`, `PROVIDER_ERROR`, `TIMED_OUT`, `INTERNAL`).

Un nuevo Run usa el Price vigente al admitirse y lo conserva hasta la liquidación. La versión de un
Endpoint no bloquea el Price para futuros Runs.

Los importes son cadenas decimales exactas en USD, como `"0.005"`. Usa aritmética decimal,
no de coma flotante, al sumarlos.

## Estado del Run

Antes de crear un Run, Glasser comprueba el acceso y los fondos disponibles, y coloca una
**Hold** por el cargo máximo. Una solicitud rechazada no crea ningún Run ni cargo.
Cuando el Run termina, Glasser cierra la Hold y registra el cargo final.

| Estado | Significado |
| - | - |
| `QUEUED` | Aceptado y a la espera del envío. |
| `RUNNING` | La ejecución está en curso. |
| `COMPLETED` | Finalizado con un Provider response, que puede incluir un error. |
| `FAILED` | Finalizado sin un Provider response utilizable. Lee `failure` para conocer el motivo. |
| `STOPPED` | Detenido antes del envío, sin cargo. |

Una solicitud de detención posterior al envío no cancela el trabajo del Provider. Lee el
estado devuelto y el cargo final; consulta [Detener un Run](https://glasser.ai/docs/es/api-reference/runs/stop.md).

## Leer el resultado y el cargo

Comprueba estos campos por separado:

| Campo | Qué indica |
| - | - |
| `status` | Si el Run sigue en curso o ha terminado. |
| `provider_response` | Si el Provider devolvió datos o un error. Un 404 o 500 del Provider puede corresponder a un Run `COMPLETED`. |
| `charge_usd` | Qué cargo generó el Run. Un Run `FAILED` todavía puede tener un cargo conforme a su Price. |

## Reintentar sin un segundo cargo

Después de un tiempo de espera agotado o de perder la conexión, reintenta con la **misma clave de idempotencia** para
recuperar el Run original sin iniciar otro ni generar otro cargo.

* Mantén iguales `provider`, `endpoint`, `input` y `endpoint_version`.
* Cambiar esos parámetros de ejecución con la misma clave devuelve un conflicto.
* Usa una clave nueva solo cuando quieras iniciar otro Run.

Cambiar `task_id` o `metadata` no crea un Run nuevo ni actualiza el Run original.
Las respuestas de MCP también incluyen `replayed: true` para reintentar; las respuestas de la API HTTP y de la CLI devuelven
el Run sin este campo.

## Claves y políticas

Una **Key** pertenece a un **Workspace**. Los Runs usan el saldo de ese Workspace.

Un Endpoint debe estar permitido tanto por la Policy del Workspace como por la Policy de la Key.
Search omite los Endpoints que quedan fuera de ese acceso; Inspect devuelve que no se encuentran.

## Añadir fondos

Añade fondos en la [página de saldo](https://app.glasser.ai/balance?utm_source=docs\&utm_medium=how-it-works).
La API, la CLI y MCP no pueden añadir fondos.

| Método | Qué requiere |
| - | - |
| Recarga | Paga con tarjeta. La recarga automática puede repetir el pago. |
| Referido | Comparte tu enlace de referido. Ambos Workspaces reciben un Grant al registrarse; tú recibes otro cuando el nuevo usuario recarga fondos y ejecuta algo. |
| Compartir un Run | Comparte un Run `COMPLETED` en X o LinkedIn y envía después el enlace de la publicación para solicitar un Grant. Requiere una recarga anterior. |

Un Grant es saldo gratuito: no caduca y se utiliza como cualquier otro saldo. Cada nuevo
Workspace empieza con un Grant de registro. Los Grants de referidos y de publicaciones tienen límites de por vida por
Workspace; la consola muestra los importes y límites actuales. Los Grants aparecen en el historial del saldo
con el tipo `grant`.

## Un modelo, cuatro superficies

Las mismas reglas de ejecución, facturación y políticas se aplican a la [API HTTP](https://glasser.ai/docs/es/api-reference/endpoints/search.md),
a la [CLI](https://glasser.ai/docs/es/cli.md), al [servidor MCP](https://glasser.ai/docs/es/mcp-server.md) y al Skill del agent.


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