Saltar para o conteúdo principal

​
Visão geral dos comandos

CommandDescriptionAuth
chat [MESSAGE]Envie uma mensagem ou inicie o REPL interativoChave de API
modelsListe e pesquise modelos disponíveisChave de API
balanceMostre o saldo da contaChave de API (ou access token)
accountMostre o perfil da contaAccess token
statsMostre estatísticas de usoAccess token
tokensListe e pesquise suas chaves de APIAccess token
logsNavegue pelos logs de uso com filtrosAccess token
tasksMostre logs de tarefas assíncronasAccess token
initAssistente de configuração interativo—
doctorExecute diagnósticos e verificações de integridadeChave de API
configGerencie a configuração da CLI—
replInicie o shell de comandos interativoChave de API
Os comandos marcados como Access token exigem a variável de ambiente COMETAPI_ACCESS_TOKEN ou a chave de configuração access_token. Consulte o guia de configuração para mais detalhes.

​
Chat

Envie uma única mensagem ou inicie o REPL interativo de múltiplos turnos. 
# Single message (streaming by default)
cometapi chat "Explain quantum computing in one sentence"

# Override model and add a system prompt
cometapi chat "Summarize this" --model claude-sonnet-4-6 --system "Be concise"

# Disable streaming
cometapi chat "Hello" --no-stream

# JSON output (full API response)
cometapi chat "Hello" --json

# Interactive REPL (omit message)
cometapi chat
OptionShortDescription
--model-mModelo a ser usado (padrão: da configuração)
--system-sPrompt de sistema
--temperature-tTemperatura de amostragem (0.0–2.0)
--max-tokensMáximo de tokens na resposta
--stream/--no-streamAtiva ou desativa Streaming (padrão: stream)
--format-fFormato de saída
--jsonSaída em JSON

​
Models

Liste os modelos disponíveis com pesquisa e limite opcionais. 
# List all models
cometapi models

# Search by keyword
cometapi models --search gemini

# Limit results and output as JSON
cometapi models --search gpt --limit 10 --json
OptionShortDescription
--search-sFiltra os modelos por palavra-chave
--limit-lNúmero máximo de resultados
--format-fFormato de saída
--jsonSaída em JSON

​
Balance

Mostre o saldo da sua conta CometAPI. 
# Default: account-level balance (falls back to per-key billing)
cometapi balance

# Force account-level view
cometapi balance --source account

# Force API key billing view
cometapi balance --source key

# JSON output
cometapi balance --json
OptionShortDescription
--source-sFonte de dados: account (conta completa) ou key (chave de API atual).
--format-fFormato de saída
--jsonSaída em JSON

​
Account

Mostre o perfil da sua conta. Requer um access token. 
cometapi account
cometapi account --json
OptionShortDescription
--format-fFormato de saída
--jsonSaída em JSON

​
Stats

Mostre estatísticas de uso do mês atual. Requer um access token. 
cometapi stats
cometapi stats --json
A saída inclui: contagem de requisições, valor de uso, taxa de sucesso e previsão de dias restantes de saldo.
OptionShortDescription
--format-fFormato de saída
--jsonSaída em JSON

​
Tokens

Liste e pesquise suas chaves de API. Requer um token de acesso. 
# List API keys (paginated)
cometapi tokens

# Search by keyword
cometapi tokens --search raycast

# JSON output
cometapi tokens --json
OptionShortDescription
--search-sPalavra-chave de pesquisa
--page-pNúmero da página
--page-sizeResultados por página
--format-fFormato de saída
--jsonSaída em JSON

​
Logs

Navegue pelos logs de uso com filtros. Requer um token de acesso. 
# Recent logs
cometapi logs

# Filter by model
cometapi logs --model gpt-5.4

# Filter by date range
cometapi logs --start 2026-04-01 --end 2026-04-14

# Filter by log type
cometapi logs --type consume

# Export as CSV
cometapi logs --export > usage.csv

# JSON output with limit
cometapi logs --limit 50 --json
OptionShortDescription
--model-mFiltrar por model ID
--token-nameFiltrar por nome da chave de API
--type-tTipo de log: consume, topup, error, refund, system, manage
--startData de início (YYYY-MM-DD)
--endData de término (YYYY-MM-DD)
--group-gFiltrar por grupo
--limit-lNúmero máximo de entradas
--page-pNúmero da página
--page-sizeResultados por página
--exportSaída como CSV para stdout
--format-fFormato de saída
--jsonSaída em JSON

​
Tasks

Mostre logs de tarefas assíncronas para plataformas como Suno, Midjourney, Luma e Kling. Requer um token de acesso. 
# Recent tasks
cometapi tasks

# Filter by platform
cometapi tasks --platform suno

# Filter by status
cometapi tasks --status SUCCESS

# JSON output
cometapi tasks --json
OptionShortDescription
--platformFiltrar por nome da plataforma
--statusFiltrar por status
--limit-lNúmero máximo de entradas
--format-fFormato de saída
--jsonSaída em JSON

​
Doctor

Execute diagnósticos para verificar a configuração da CLI e a conectividade com a API. 
cometapi doctor
cometapi doctor --json
O doctor verifica:
  • Existência e legibilidade do arquivo de configuração
  • Disponibilidade da chave de API e origem (config, env ou ausente)
  • Disponibilidade do token de acesso
  • Conectividade de rede com o endpoint da CometAPI
  • Validade da autenticação da API
OptionShortDescription
--format-fFormato de saída
--jsonSaída em JSON

​
Config

Gerencie a configuração da CLI armazenada em ~/.config/cometapi/config.toml. 
# Show current config
cometapi config show

# Set a value
cometapi config set api_key sk-...
cometapi config set default_model claude-sonnet-4-6
cometapi config set output_format json

# Remove a value
cometapi config unset api_key

# Show config file path
cometapi config path
Veja o guia de configuração para todas as chaves disponíveis.

​
Init

Execute o assistente de configuração interativo para configurar sua chave de API e token de acesso. 
cometapi init
O assistente grava as configurações em ~/.config/cometapi/config.toml.

​
Repl

Inicie um shell de comando interativo completo no qual você pode executar qualquer comando da CLI sem o prefixo cometapi. 
cometapi repl

​
Formatos de saída

Todos os comandos de dados oferecem suporte a --json ou --format: 
cometapi models --json
cometapi models --format yaml
cometapi stats --format csv
cometapi account --format markdown
FormatDescription
tableTabela rica no terminal (padrão)
jsonSaída em JSON
yamlSaída em YAML
csvValores separados por vírgula
markdownTabela Markdown
Defina um formato padrão para todos os comandos via config: 
cometapi config set output_format json

​
Complemento de shell

Instale o complemento de shell para suporte a autocompletar com tabulação: 
cometapi --install-completion
Shells compatíveis: Bash, Zsh, Fish.

​
Códigos de saída

CódigoSignificado
0Sucesso
1Erro geral
2Argumentos inválidos
64Configuração ausente
69Serviço indisponível
77Erro de autenticação