Saltar al contenido principal
Busca, inspecciona y ejecuta Endpoints de API de pago con una sola Key: las mismas tres llamadas que en la API, desde la terminal.

​
Instalación

Requiere Node.js 22 o posterior; npm es opcional. Vuelve a ejecutar cualquiera de los dos comandos para actualizar.

​
Autenticación

Ejecuta este comando para abrir el inicio de sesión en el navegador y guardar una Key para tu Workspace:
Aprueba solo cuando el código del navegador coincida con el de la terminal. Consulta glasser login para ver las opciones de inicio de sesión. Para CI y scripts, crea una Key en la consola y establece GLASSER_API_KEY, o usa glasser keys add.

​
Comandos

Elige un comando en la barra lateral o abre su referencia a continuación. Cada página de comando muestra su sintaxis y sus opciones.

​
Mantener las llamadas en un solo Task

Una búsqueda devuelve un task_id. Pasa ese valor con --task en las búsquedas relacionadas, incluidos los reintentos con palabras diferentes y las solicitudes de la página siguiente, así como en inspect y run. La CLI no almacena ni reutiliza Task automáticamente. Cada búsqueda sigue requiriendo --use-case, incluso cuando pasas --task.
Sustituye <taskId> a continuación por el task_id de esa respuesta. Usa el proveedor de datos, el Endpoint y la entrada seleccionados mediante la búsqueda y la inspección.
Omitir --task inicia un Task nuevo en cada búsqueda. En inspect y run, omitirlo deja la llamada sin Task. En runs list, --task filtra los resultados para ese Task.

​
Opciones globales

Opciones globales en cada comando: -j/--json, --help, --version.

​
Modo JSON

Con -j/--json, los resultados del comando en stdout son JSON. Stderr está vacío cuando la operación se realiza correctamente y contiene un objeto de error JSON cuando falla. Las solicitudes explícitas de --help y --version siguen generando texto.
  • run --json requiere --idempotency-key para que puedas reintentar con la misma key.
  • keys remove --json requiere --force para omitir la confirmación interactiva.
  • login --json es un error de uso porque el inicio de sesión es interactivo.
  • --output guarda solo el campo de salida del Run. Si la escritura se realiza correctamente, stdout contiene el Run completo. Si falla la escritura del archivo, stdout queda vacío, se escribe un objeto JSON io_error en stderr y el proceso termina con 1. El modo JSON no muestra mensajes de estado del archivo en stderr.
Para run y runs get, stdout sigue devolviendo un Run FAILED o STOPPED. El comando también escribe un error JSON en stderr y termina con el código 1. Las cantidades monetarias en los campos de respuesta de Glasser son cadenas decimales exactas, nunca números de coma flotante.

​
Códigos de salida

Para run y runs get, el código de salida 0 puede indicar que el Run aún está QUEUED o RUNNING cuando no usas --wait. Un Run COMPLETED también termina con 0 cuando el proveedor de datos devuelve HTTP 4xx o 5xx; consulta provider_response.http_status. El estado del Run y charge_usd son resultados independientes. runs stop termina con 0 cuando se acepta la solicitud de detención, aunque el Run siga ejecutándose. Consulta detener un Run para conocer el comportamiento completo.

​
Variables de entorno

​
Para agentes

Skill orientada a agentes en glasser.ai/SKILL.md incluye esta CLI: cuándo usarla, cómo autenticarse mediante glasser login y las reglas para mantener el gasto bajo control. Indica a tu agente que use ese archivo.