Referencia de comandos

Usa cometapi -h o cometapi <command> -h para inspeccionar los argumentos y opciones exactos de la versión instalada.

Resumen de comandos

Command	Description	Auth
`chat [MESSAGE]`	Envía un mensaje de chat o inicia el chat REPL	Clave API
`models`	Lista y filtra los metadatos del catálogo de modelos	Clave API
`model info <id>`	Inspecciona los metadatos públicos de un modelo	Clave API
`run [MODEL]`	Envía una solicitud mediante los formatos chat, responses, anthropic o gemini	Clave API
`balance`	Muestra el saldo de la cuenta o de la clave API actual	Clave API o token de acceso
`account`	Muestra el perfil de la cuenta	Token de acceso
`stats`	Muestra estadísticas de uso	Token de acceso
`tokens`	Lista y busca claves API	Token de acceso
`logs`	Explora los registros de uso con filtros	Token de acceso
`tasks`	Muestra los registros de tareas asíncronas	Token de acceso
`init`	Ejecuta el asistente de configuración	Ninguno
`doctor`	Ejecuta diagnósticos	Clave API
`config`	Administra la configuración local	Ninguno
`repl`	Inicia una shell de comandos interactiva	Depende del comando usado

Los comandos marcados como Token de acceso 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 único mensaje o inicia el chat REPL de varios turnos.

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

Option	Short	Description
`--model`	`-m`	Modelo que se va a usar
`--system`	`-s`	Prompt del sistema
`--temperature`	`-t`	Temperatura de muestreo
`--max-tokens`		Máximo de tokens de respuesta
`--stream/--no-stream`		Activa o desactiva el streaming
`--format`	`-f`	Formato de salida
`--json`		Salida como JSON

Models

Lista modelos del catálogo público de forma predeterminada. La salida del catálogo incluye model ID, proveedor, tipo de modelo, funciones, endpoints, precios, longitud de contexto y tokens máximos de finalización.

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

Option	Short	Description
`--search`	`-s`	Filtra por ID, código, nombre, descripción o proveedor
`--provider`		Filtra por nombre o código del proveedor
`--type`, `--modality`		Filtra por tipo de modelo o modalidad
`--feature`, `--capability`		Filtra por función o capacidad
`--endpoint`		Filtra por nombre, método o ruta del endpoint
`--limit`	`-l`	Número máximo de resultados
`--source`		Usa metadatos de `catalog` o el listado `openai` compatible con OpenAI
`--refresh`		Actualiza la caché del catálogo de una hora
`--no-cache`		Omite la caché del catálogo para este comando
`--format`	`-f`	Formato de salida
`--json`		Salida como JSON

La caché del catálogo se almacena en ~/.cache/cometapi/models.json.

Información del modelo

Inspecciona los metadatos públicos de un modelo. El comando resuelve el modelo mediante el catálogo público y luego carga los metadatos detallados para el código del catálogo.

cometapi model info your-model-id
cometapi model info your-model-id --json
cometapi model info your-model-id --refresh

Opción	Corta	Descripción
`--refresh`		Actualiza la caché del catálogo antes de la búsqueda
`--no-cache`		Omite la caché del catálogo para este comando
`--format`	`-f`	Formato de salida
`--json`		Devuelve el JSON bruto de detalles del modelo

La salida en tabla incluye proveedor, tipo de modelo, funciones, endpoints, precios, longitud de contexto, máximo de Tokens de finalización, URL de documentación y resumen.

Ejecutar

Envía una solicitud a través de un formato de endpoint seleccionado. Usa --input-file para un cuerpo JSON, valores repetidos de -i key=value para reemplazos y -p/--prompt como atajo para un 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

Opción	Corta	Descripción
`--endpoint`	`-e`	Formato del endpoint: `chat`, `responses`, `anthropic` o `gemini`
`--input-file`		Cuerpo de solicitud como objeto JSON
`--input`	`-i`	Entrada de la solicitud como `key=value`; repite para varios valores
`--prompt`	`-p`	Atajo de Prompt
`--json`		Devuelve la respuesta JSON bruta

Asignación de endpoints:

Endpoint	Ruta de solicitud	Autenticación
`chat`	`POST /v1/chat/completions`	API key Bearer
`responses`	`POST /v1/responses`	API key Bearer
`anthropic`	`POST /v1/messages`	API key en `x-api-key` y encabezado de versión de Anthropic
`gemini`	Ruta de modelo Gemini Generate Content	API key en `x-goog-api-key`

El orden de combinación del cuerpo es --input-file, luego -i key=value repetidos, después el atajo de prompt y, por último, el MODEL posicional. Los valores inline se interpretan como JSON cuando es posible. Las claves con puntos crean objetos anidados.

Balance

Muestra el balance de tu cuenta de CometAPI o la vista de facturación de la API key actual.

cometapi balance
cometapi balance --source account
cometapi balance --source key
cometapi balance --json

Opción	Corta	Descripción
`--source`	`-s`	Fuente de datos: `account` o `key`
`--format`	`-f`	Formato de salida
`--json`		Devuelve la salida como JSON

Cuenta

Muestra el perfil de tu cuenta. Requiere un token de acceso.

cometapi account
cometapi account --json

Estadísticas

Muestra estadísticas de uso. Requiere un token de acceso.

cometapi stats
cometapi stats --json

Tokens

Lista y busca API keys. Requiere un token de acceso.

cometapi tokens
cometapi tokens --search project
cometapi tokens --json

Opción	Corta	Descripción
`--search`	`-s`	Palabra clave de búsqueda
`--page`	`-p`	Número de página
`--limit`	`-l`	Resultados por página
`--format`	`-f`	Formato de salida
`--json`		Devuelve la salida como JSON

Logs

Explora los registros de uso con filtros. Requiere un token de acceso.

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
cometapi logs --request-id 20260617165550885561292gJBlzjtp

Option	Short	Description
`--model`	`-m`	Filtrar por model ID
`--token-name`	`-t`	Filtrar por nombre de API key
`--type`		Tipo de registro
`--search`	`-s`	Buscar palabra clave
`--start`		Fecha de inicio
`--end`		Fecha de fin
`--group`	`-g`	Filtrar por grupo de API key
`--request-id`		Buscar una solicitud por `X-Cometapi-Request-Id`
`--page`	`-p`	Número de página
`--limit`	`-l`	Resultados por página
`--export`		Enviar CSV del servidor a stdout
`--format`	`-f`	Formato de salida
`--json`		Salida como JSON

logs --request-id realiza una búsqueda indexada en el endpoint de registros del operador y solo acepta una coincidencia exacta de request_id. La CLI no recorre páginas de registros alternativas, porque el endpoint de auto-registro no aplica filtrado por request_id.

Tasks

Muestra registros de tareas asíncronas. Requiere un token de acceso.

cometapi tasks
cometapi tasks --platform kling
cometapi tasks --status SUCCESS
cometapi tasks --json

Option	Short	Description
`--platform`	`-p`	Filtrar por plataforma
`--task-id`		Filtrar por ID de tarea
`--status`	`-s`	Filtrar por estado
`--action`	`-a`	Filtrar por tipo de acción
`--start`		Fecha de inicio
`--end`		Fecha de fin
`--page`		Número de página
`--limit`	`-l`	Resultados por página
`--format`	`-f`	Formato de salida
`--json`		Salida como JSON

Doctor

Ejecuta diagnósticos para verificar la configuración y la conectividad con la API.

cometapi doctor
cometapi doctor --json

Config

Administra la configuración de la CLI almacenada en ~/.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

Consulta la guía de configuración para ver todas las claves disponibles.

Init

Ejecuta el asistente de configuración interactivo:

cometapi init

Repl

Inicia una shell de comandos interactiva completa:

cometapi repl

Output formats

La mayoría de 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
`json`	Salida JSON
`yaml`	Salida YAML
`csv`	Valores separados por comas
`markdown`	Tabla Markdown

Empieza aquí

Guías rápidas de la API de modelos

Guías principales de la API

Bibliotecas

Errores

Precios y facturación

Soporte

Resumen de comandos

Chat

Models

Información del modelo

Ejecutar

Balance

Cuenta

Estadísticas

Tokens

Logs

Tasks

Doctor

Config

Init

Repl

Output formats

​Resumen de comandos

​Chat

​Models

​Información del modelo

​Ejecutar

​Balance

​Cuenta

​Estadísticas

​Tokens

​Logs

​Tasks

​Doctor

​Config

​Init

​Repl

​Output formats

Resumen de comandos

Chat

Models

Información del modelo

Ejecutar

Balance

Cuenta

Estadísticas

Tokens

Logs

Tasks

Doctor

Config

Init

Repl

Output formats