Pular para o conteúdo principal
Pesquise, inspecione e execute endpoints de API pagos com uma única Key — as mesmas três chamadas da API, a partir do terminal.

​
Instalação

Requer Node.js 22 ou mais recente; o npm é opcional. Execute novamente qualquer um dos comandos para atualizar.

​
Autenticação

Execute este comando para abrir o login no navegador e armazenar uma Key para seu Workspace:
Aprove somente quando o código no navegador corresponder ao do terminal. Consulte glasser login para ver as opções de login. Para CI e scripts, crie uma Key no console e defina GLASSER_API_KEY, ou use glasser keys add.

​
Comandos

Escolha um comando na barra lateral ou abra sua referência abaixo. Cada página de comando lista sua sintaxe e suas opções.

​
Mantenha as chamadas em um único Task

Uma pesquisa retorna um task_id. Passe esse valor com --task em pesquisas relacionadas, incluindo novas tentativas com palavras diferentes e solicitações da próxima página, e em inspect e run. A CLI não armazena nem reutiliza o Task automaticamente. Cada pesquisa ainda exige --use-case, mesmo quando você passa --task.
Substitua <taskId> abaixo pelo task_id dessa resposta. Use o Provider, o Endpoint e a entrada selecionados durante a pesquisa e a inspeção.
Omitir --task inicia um novo Task a cada pesquisa. Em inspect e run, omiti-lo deixa a chamada sem um Task. Em runs list, --task filtra os resultados para esse Task.

​
Flags globais

Flags globais em todos os comandos: -j/--json, --help, --version.

​
Modo JSON

Com -j/--json, os resultados dos comandos em stdout são JSON. Stderr fica vazio em caso de sucesso e contém um objeto de erro JSON em caso de falha. Solicitações explícitas de --help e --version ainda produzem texto.
  • run --json exige --idempotency-key para que você possa tentar novamente com a mesma chave.
  • keys remove --json exige --force para ignorar a confirmação interativa.
  • login --json é um erro de uso porque o login é interativo.
  • --output salva apenas o campo de saída do Run. Após uma gravação bem-sucedida, stdout contém o Run completo. Uma falha ao gravar o arquivo deixa stdout vazio, grava um objeto JSON io_error em stderr e encerra com 1. O modo JSON não imprime mensagens de status do arquivo em stderr.
Para run e runs get, um Run FAILED ou STOPPED ainda é retornado em stdout. O comando também grava um erro JSON em stderr e encerra com o código 1. Os valores monetários nos campos de resposta do Glasser são strings decimais exatas, nunca números de ponto flutuante.

​
Códigos de saída

Para run e runs get, a saída 0 pode significar que o Run ainda está QUEUED ou RUNNING quando você não usa --wait. Um Run COMPLETED também termina com 0 quando o Provider retorna HTTP 4xx ou 5xx; verifique provider_response.http_status. O status do Run e charge_usd são resultados separados. runs stop termina com 0 quando a solicitação de interrupção é aceita, mesmo que o Run ainda esteja em execução. Consulte interrompendo um Run para ver o comportamento completo.

​
Variáveis de ambiente

​
Para agentes

O Skill voltado para agentes em glasser.ai/SKILL.md inclui esta CLI — quando usá-la, como se autenticar por meio de glasser login e as regras que mantêm os gastos deliberados. Aponte seu agente para esse arquivo.