Saltar al contenido principal

​
Resumen de comandos

CommandDescriptionAuth
chat [MESSAGE]Envía un mensaje o inicia el REPL interactivoAPI key
modelsLista y busca modelos disponiblesAPI key
balanceMuestra el saldo de la cuentaAPI key (o access token)
accountMuestra el perfil de la cuentaAccess token
statsMuestra estadísticas de usoAccess token
tokensLista y busca tus API keysAccess token
logsExplora registros de uso con filtrosAccess token
tasksMuestra registros de tareas asíncronasAccess token
initAsistente de configuración interactivo—
doctorEjecuta diagnósticos y comprobaciones de estadoAPI key
configAdministra la configuración de la CLI—
replInicia la shell de comandos interactivaAPI key
Los comandos marcados como Access token requieren la variable de entorno COMETAPI_ACCESS_TOKEN o la clave de configuración access_token. Consulta la guía de configuración para más detalles.

​
Chat

Envía un solo mensaje o inicia el REPL interactivo de múltiples 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 que se usará (predeterminado: desde la configuración)
--system-sPrompt del sistema
--temperature-tTemperatura de muestreo (0.0–2.0)
--max-tokensMáximo de tokens en la respuesta
--stream/--no-streamHabilita o deshabilita Streaming (predeterminado: stream)
--format-fFormato de salida
--jsonSalida como JSON

​
Models

Lista los modelos disponibles con búsqueda y límite opcionales. 
# 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 modelos por palabra clave
--limit-lNúmero máximo de resultados
--format-fFormato de salida
--jsonSalida como JSON

​
Balance

Muestra el saldo de tu cuenta de 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-sFuente de datos: account (cuenta completa) o key (API key actual).
--format-fFormato de salida
--jsonSalida como JSON

​
Account

Muestra el perfil de tu cuenta. Requiere un access token. 
cometapi account
cometapi account --json
OptionShortDescription
--format-fFormato de salida
--jsonSalida como JSON

​
Stats

Muestra estadísticas de uso del mes actual. Requiere un access token. 
cometapi stats
cometapi stats --json
La salida incluye: cantidad de solicitudes, monto de uso, tasa de éxito y días previstos de saldo restante.
OptionShortDescription
--format-fFormato de salida
--jsonSalida como JSON

​
Tokens

Lista y busca tus API keys. Requiere un access token. 
# List API keys (paginated)
cometapi tokens

# Search by keyword
cometapi tokens --search raycast

# JSON output
cometapi tokens --json
OptionShortDescription
--search-sPalabra clave de búsqueda
--page-pNúmero de página
--page-sizeResultados por página
--format-fFormato de salida
--jsonSalida como JSON

​
Logs

Explora registros de uso con filtros. Requiere un access token. 
# 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-mFiltra por model ID
--token-nameFiltra por nombre de API key
--type-tTipo de registro: consume, topup, error, refund, system, manage
--startFecha de inicio (YYYY-MM-DD)
--endFecha de fin (YYYY-MM-DD)
--group-gFiltra por grupo
--limit-lNúmero máximo de entradas
--page-pNúmero de página
--page-sizeResultados por página
--exportSalida como CSV a stdout
--format-fFormato de salida
--jsonSalida como JSON

​
Tasks

Muestra registros de tareas asíncronas para plataformas como Suno, Midjourney, Luma y Kling. Requiere un access token. 
# Recent tasks
cometapi tasks

# Filter by platform
cometapi tasks --platform suno

# Filter by status
cometapi tasks --status SUCCESS

# JSON output
cometapi tasks --json
OptionShortDescription
--platformFiltra por nombre de plataforma
--statusFiltra por estado
--limit-lNúmero máximo de entradas
--format-fFormato de salida
--jsonSalida como JSON

​
Doctor

Ejecuta diagnósticos para verificar la configuración de la CLI y la conectividad de la API. 
cometapi doctor
cometapi doctor --json
El doctor comprueba:
  • La existencia y legibilidad del archivo de configuración
  • La disponibilidad del API key y su origen (configuración, env o ausente)
  • La disponibilidad del access token
  • La conectividad de red con el endpoint de CometAPI
  • La validez de la autenticación de la API
OptionShortDescription
--format-fFormato de salida
--jsonSalida como JSON

​
Config

Administra la configuración de la CLI almacenada en ~/.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
Consulta la guía de configuración para ver todas las claves disponibles.

​
Init

Ejecuta el asistente de configuración interactivo para configurar tu API key y access token. 
cometapi init
El asistente escribe la configuración en ~/.config/cometapi/config.toml.

​
Repl

Inicia una shell de comandos interactiva completa donde puedes ejecutar cualquier comando de la CLI sin el prefijo cometapi. 
cometapi repl

​
Formatos de salida

Todos los comandos de datos admiten --json o --format: 
cometapi models --json
cometapi models --format yaml
cometapi stats --format csv
cometapi account --format markdown
FormatDescription
tableTabla enriquecida en la terminal (predeterminado)
jsonSalida JSON
yamlSalida YAML
csvValores separados por comas
markdownTabla Markdown
Configura un formato predeterminado para todos los comandos mediante la configuración: 
cometapi config set output_format json

​
Autocompletado de shell

Instala el autocompletado de shell para admitir autocompletado con tabulación: 
cometapi --install-completion
Shells compatibles: Bash, Zsh, Fish.

​
Códigos de salida

CodeMeaning
0Éxito
1Error general
2Argumentos no válidos
64Falta configuración
69Servicio no disponible
77Error de autenticación