Saltar para o conteúdo principal
Use cometapi -h ou cometapi <command> -h para verificar os argumentos e opções exatos da versão instalada.

​
Visão geral dos comandos

CommandDescriptionAuth
chat [MESSAGE]Envie uma mensagem de chat ou inicie o chat REPLChave de API
modelsListe e filtre os metadados do catálogo de modelosChave de API
model info <id>Inspecione os metadados públicos de um modeloChave de API
run [MODEL]Envie uma solicitação usando os formatos chat, responses, anthropic ou geminiChave de API
balanceMostre o saldo da conta ou da chave de API atualChave de API ou token de acesso
accountMostre o perfil da contaToken de acesso
statsMostre estatísticas de usoToken de acesso
tokensListe e pesquise chaves de APIToken de acesso
logsNavegue pelos logs de uso com filtrosToken de acesso
tasksMostre logs de tarefas assíncronasToken de acesso
initExecute o assistente de configuraçãoNenhuma
doctorExecute diagnósticosChave de API
configGerencie a configuração localNenhuma
replInicie um shell de comando interativoDepende do comando usado
Os comandos marcados como Token de acesso exigem a variável de ambiente COMETAPI_ACCESS_TOKEN ou a chave de configuração access_token. Veja o guia de configuração para mais detalhes.

​
Chat

Envie uma única mensagem ou inicie o chat REPL de múltiplas interações. 
cometapi chat "Explain CometAPI in one sentence."
cometapi chat "Summarize this" --model your-model-id --system "Be concise."
cometapi chat "Hello" --no-stream
cometapi chat "Hello" --json
cometapi chat
OptionShortDescription
--model-mModelo a ser usado
--system-sPrompt do sistema
--temperature-tTemperatura de amostragem
--max-tokensMáximo de tokens da resposta
--stream/--no-streamHabilita ou desabilita Streaming
--format-fFormato de saída
--jsonSaída em JSON

​
Models

Liste modelos do catálogo público por padrão. A saída do catálogo inclui model ID, provedor, tipo de modelo, recursos, endpoints, preços, comprimento de contexto e número máximo de tokens de conclusão. 
cometapi models
cometapi models --search gpt --limit 10
cometapi models --provider openai --type chat --limit 10
cometapi models --feature image --endpoint responses --json
cometapi models --refresh
cometapi models --source openai --search gpt
OptionShortDescription
--search-sFiltre por ID, código, nome, descrição ou provedor
--providerFiltre por nome ou código do provedor
--type, --modalityFiltre por tipo de modelo ou modalidade
--feature, --capabilityFiltre por recurso ou capacidade
--endpointFiltre por nome, método ou caminho do endpoint
--limit-lNúmero máximo de resultados
--sourceUse os metadados catalog ou a listagem openai compatível com OpenAI
--refreshAtualize o cache do catálogo de uma hora
--no-cacheIgnore o cache do catálogo para este comando
--format-fFormato de saída
--jsonSaída em JSON
O cache do catálogo é armazenado em ~/.cache/cometapi/models.json.

​
Informações do model

Inspecione metadados públicos de um model. O comando resolve o model por meio do catálogo público e, em seguida, carrega os metadados de detalhe para o código do catálogo. 
cometapi model info your-model-id
cometapi model info your-model-id --json
cometapi model info your-model-id --refresh
OpçãoCurtoDescrição
--refreshAtualiza o cache do catálogo antes da busca
--no-cacheIgnora o cache do catálogo para este comando
--format-fFormato de saída
--jsonExibe o JSON bruto dos detalhes do model
A saída da tabela inclui provider, model type, features, endpoints, pricing, comprimento do contexto, número máximo de tokens de completion, URL da documentação e visão geral.

​
Executar

Envie uma request por um formato de endpoint selecionado. Use --input-file para um corpo JSON, valores repetidos de -i key=value para sobrescritas e -p/--prompt para um atalho de prompt. 
cometapi run your-model-id -p "Write one sentence about CometAPI."
cometapi run your-model-id --endpoint responses -p "Reply with OK only." -i max_output_tokens=32 --json
cometapi run your-model-id --endpoint anthropic -p "Reply with OK only." -i max_tokens=32
cometapi run your-model-id --endpoint gemini -p "Reply with OK only." -i generationConfig.maxOutputTokens=32
cometapi run your-model-id --endpoint responses --input-file body.json -i temperature=0.2 --json
OpçãoCurtoDescrição
--endpoint-eFormato do endpoint: chat, responses, anthropic ou gemini
--input-fileCorpo da request em objeto JSON
--input-iEntrada da request como key=value; repita para múltiplos valores
--prompt-pAtalho de prompt
--jsonExibe a resposta JSON bruta
Mapeamento de endpoint:
EndpointCaminho da requestAuth
chatPOST /v1/chat/completionsBearer API key
responsesPOST /v1/responsesBearer API key
anthropicPOST /v1/messagesx-api-key API key e cabeçalho de versão Anthropic
geminiCaminho do model Generate Content do GeminiAPI key x-goog-api-key
A ordem de merge do body é --input-file, valores repetidos de -i key=value, atalho de prompt e, por fim, MODEL posicional. Valores inline são interpretados como JSON quando possível. Chaves com ponto criam objetos aninhados.

​
Saldo

Mostre o saldo da sua conta CometAPI ou a visualização de cobrança da API key atual. 
cometapi balance
cometapi balance --source account
cometapi balance --source key
cometapi balance --json
OpçãoCurtoDescrição
--source-sFonte de dados: account ou key
--format-fFormato de saída
--jsonExibe como JSON

​
Conta

Mostre o perfil da sua conta. Requer um access token. 
cometapi account
cometapi account --json

​
Estatísticas

Mostre as estatísticas de uso. Requer um access token. 
cometapi stats
cometapi stats --json

​
Tokens

Liste e pesquise API keys. Requer um access token. 
cometapi tokens
cometapi tokens --search project
cometapi tokens --json
OpçãoCurtoDescrição
--search-sPalavra-chave de pesquisa
--page-pNúmero da página
--limit-lResultados por página
--format-fFormato de saída
--jsonExibe como JSON

​
Logs

Navegue pelos logs de uso com filtros. Requer um token de acesso. 
cometapi logs
cometapi logs --model your-model-id
cometapi logs --start 2026-04-01 --end 2026-04-14
cometapi logs --type consume
cometapi logs --export > usage.csv
cometapi logs --limit 50 --json
OptionShortDescription
--model-mFiltrar por model ID
--token-name-tFiltrar por nome da API key
--typeTipo de log
--search-sPalavra-chave de busca
--startData de início
--endData de término
--group-gFiltrar por grupo de API key
--page-pNúmero da página
--limit-lResultados por página
--exportEnviar CSV do servidor para stdout
--format-fFormato de saída
--jsonSaída em JSON

​
Tasks

Mostre logs de tarefas assíncronas. Requer um token de acesso. 
cometapi tasks
cometapi tasks --platform kling
cometapi tasks --status SUCCESS
cometapi tasks --json
OptionShortDescription
--platform-pFiltrar por plataforma
--task-idFiltrar por ID da tarefa
--status-sFiltrar por status
--action-aFiltrar por tipo de ação
--startData de início
--endData de término
--pageNúmero da página
--limit-lResultados por página
--format-fFormato de saída
--jsonSaída em JSON

​
Doctor

Execute diagnósticos para verificar a configuração e a conectividade com a API. 
cometapi doctor
cometapi doctor --json

​
Config

Gerencie a configuração da CLI armazenada em ~/.config/cometapi/config.toml. 
cometapi config show
cometapi config set api_key "$COMETAPI_KEY"
cometapi config set default_model your-model-id
cometapi config unset api_key
cometapi config path
Consulte o guia de configuração para ver todas as chaves disponíveis.

​
Init

Execute o assistente interativo de configuração: 
cometapi init

​
Repl

Inicie um shell de comandos interativo completo: 
cometapi repl

​
Output formats

A maioria dos comandos de dados oferece 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
jsonSaída em JSON
yamlSaída em YAML
csvValores separados por vírgula
markdownTabela em Markdown