Documentation Index
Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
Use this file to discover all available pages before exploring further.
Resumen de comandos
| Command | Description | Auth |
|---|
chat [MESSAGE] | Envía un mensaje o inicia el REPL interactivo | API key |
models | Lista y busca modelos disponibles | API key |
balance | Muestra el saldo de la cuenta | API key (o access token) |
account | Muestra el perfil de la cuenta | Access token |
stats | Muestra estadísticas de uso | Access token |
tokens | Lista y busca tus API keys | Access token |
logs | Explora registros de uso con filtros | Access token |
tasks | Muestra registros de tareas asíncronas | Access token |
init | Asistente de configuración interactivo | — |
doctor | Ejecuta diagnósticos y comprobaciones de estado | API key |
config | Administra la configuración de la CLI | — |
repl | Inicia la shell de comandos interactiva | API key |
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
| Option | Short | Description |
|---|
--model | -m | Modelo que se usará (predeterminado: desde la configuración) |
--system | -s | Prompt del sistema |
--temperature | -t | Temperatura de muestreo (0.0–2.0) |
--max-tokens | | Máximo de tokens en la respuesta |
--stream/--no-stream | | Habilita o deshabilita Streaming (predeterminado: stream) |
--format | -f | Formato de salida |
--json | | Salida 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
| Option | Short | Description |
|---|
--search | -s | Filtra modelos por palabra clave |
--limit | -l | Número máximo de resultados |
--format | -f | Formato de salida |
--json | | Salida 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
| Option | Short | Description |
|---|
--source | -s | Fuente de datos: account (cuenta completa) o key (API key actual). |
--format | -f | Formato de salida |
--json | | Salida como JSON |
Account
Muestra el perfil de tu cuenta. Requiere un access token.
cometapi account
cometapi account --json
| Option | Short | Description |
|---|
--format | -f | Formato de salida |
--json | | Salida como JSON |
Stats
Muestra estadísticas de uso del mes actual. Requiere un access token.
cometapi stats
cometapi stats --json
| Option | Short | Description |
|---|
--format | -f | Formato de salida |
--json | | Salida 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
| Option | Short | Description |
|---|
--search | -s | Palabra clave de búsqueda |
--page | -p | Número de página |
--page-size | | Resultados por página |
--format | -f | Formato de salida |
--json | | Salida 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
| Option | Short | Description |
|---|
--model | -m | Filtra por model ID |
--token-name | | Filtra por nombre de API key |
--type | -t | Tipo de registro: consume, topup, error, refund, system, manage |
--start | | Fecha de inicio (YYYY-MM-DD) |
--end | | Fecha de fin (YYYY-MM-DD) |
--group | -g | Filtra por grupo |
--limit | -l | Número máximo de entradas |
--page | -p | Número de página |
--page-size | | Resultados por página |
--export | | Salida como CSV a stdout |
--format | -f | Formato de salida |
--json | | Salida como JSON |
Tasks
Muestra registros de tareas asíncronas para plataformas como Midjourney, Luma y Kling. Requiere un access token.
# Recent tasks
cometapi tasks
# Filter by platform
cometapi tasks --platform kling
# Filter by status
cometapi tasks --status SUCCESS
# JSON output
cometapi tasks --json
| Option | Short | Description |
|---|
--platform | | Filtra por nombre de plataforma |
--status | | Filtra por estado |
--limit | -l | Número máximo de entradas |
--format | -f | Formato de salida |
--json | | Salida 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
- 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
| Option | Short | Description |
|---|
--format | -f | Formato de salida |
--json | | Salida 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
Init
Ejecuta el asistente de configuración interactivo para configurar tu API key y access token.
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.
Todos los comandos de datos admiten --json o --format:
cometapi models --json
cometapi models --format yaml
cometapi stats --format csv
cometapi account --format markdown
| Format | Description |
|---|
table | Tabla enriquecida en la terminal (predeterminado) |
json | Salida JSON |
yaml | Salida YAML |
csv | Valores separados por comas |
markdown | Tabla Markdown |
cometapi config set output_format json
Autocompletado de shell
Instala el autocompletado de shell para admitir autocompletado con tabulación:
cometapi --install-completion
Códigos de salida
| Code | Meaning |
|---|
0 | Éxito |
1 | Error general |
2 | Argumentos no válidos |
64 | Falta configuración |
69 | Servicio no disponible |
77 | Error de autenticación |
