CometAPI CLI

CometAPI CLI es la herramienta oficial de línea de comandos para CometAPI. Te ayuda a chatear con modelos, inspeccionar el catálogo de modelos, enviar solicitudes puntuales, comprobar el saldo y explorar el uso de la cuenta desde la terminal. Usa la página del paquete en PyPI como página de inicio pública para la instalación y los metadatos del paquete. Esta documentación amplía los mismos comandos sin requerir acceso al repositorio privado de código fuente.

CometAPI CLI está en beta. Los nombres de los comandos y las opciones pueden cambiar mientras la interfaz se estabiliza.

Características

Chatea con modelos usando salida en streaming o un REPL interactivo
Explora metadatos del catálogo de modelos, incluidos los campos de provider, modality, endpoint, capability, context y pricing
Inspecciona un modelo con cometapi model info <id>
Envía una solicitud a través de los formatos Chat Completions, Responses, Anthropic Messages o Gemini Generate Content con cometapi run
Comprueba el saldo, el perfil de la cuenta, las estadísticas de uso, las API keys, los logs y el historial de tareas asíncronas
Exporta datos en formato de tabla, JSON, YAML, CSV o Markdown
Guarda la configuración local en ~/.config/cometapi/config.toml

Requisitos previos

Python 3.10 o posterior
Una API key de CometAPI

Instala el CLI

Instala el paquete desde PyPI:

pip install cometapi-cli

pipx install cometapi-cli

uv tool install cometapi-cli

Verifica el comando instalado:

cometapi --version
cometapi -h

Empezar a usar el CLI

Configura las credenciales

Ejecuta el asistente de configuración:

cometapi init

También puedes configurar la API key con una variable de entorno:

export COMETAPI_KEY="your-api-key"

El valor opcional COMETAPI_ACCESS_TOKEN solo es necesario para los comandos account, stats, tokens, logs y tasks.

Chatea con un modelo

Envía un solo mensaje de chat:

cometapi chat "Explain CometAPI in one sentence."

Ejecuta cometapi chat sin un mensaje para iniciar el REPL de chat.

Explora modelos

Busca en el catálogo público de modelos:

cometapi models --search gpt --limit 10

Filtra por metadatos del catálogo:

cometapi models --provider openai --type chat --limit 10
cometapi models --feature image --endpoint responses --json

Inspecciona un modelo

Muestra los metadatos detallados de un modelo:

cometapi model info your-model-id

Muestra el payload de detalle en bruto:

cometapi model info your-model-id --json

Ejecuta una solicitud multiprotocolo

Envía una solicitud puntual a través del endpoint de chat predeterminado:

cometapi run your-model-id -p "Reply with OK only."

Selecciona otro formato de endpoint cuando el cuerpo de tu solicitud siga un esquema de proveedor distinto:

cometapi run your-model-id --endpoint responses -p "Reply with OK only." --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

Obtener ayuda de los comandos

Usa -h en el comando raíz o en cualquier subcomando para inspeccionar las opciones de la versión instalada:

cometapi -h
cometapi models -h
cometapi model info -h
cometapi run -h

Comandos principales

Command	Description
`chat [MESSAGE]`	Enviar un mensaje de chat o iniciar el REPL de chat
`models`	Listar y filtrar metadatos del catálogo de modelos
`model info <id>`	Inspeccionar los metadatos públicos de un modelo
`run [MODEL]`	Enviar una solicitud a través de formatos chat, responses, anthropic o gemini
`balance`	Mostrar el saldo de la cuenta o de la API key
`account`	Mostrar el perfil de la cuenta
`stats`	Mostrar estadísticas de uso
`tokens`	Listar y buscar API keys
`logs`	Explorar registros de uso y exportar CSV
`tasks`	Explorar registros de tareas asíncronas
`init`	Ejecutar el asistente de configuración
`doctor`	Ejecutar diagnósticos de configuración
`config`	Administrar la configuración local
`repl`	Iniciar una shell de comandos interactiva

Empieza aquí

Guías rápidas de la API de modelos

Guías principales de la API

Bibliotecas

Errores

Precios y facturación

Soporte

Características

Requisitos previos

Instala el CLI

Empezar a usar el CLI

Obtener ayuda de los comandos

Comandos principales

Enlaces

​Características

​Requisitos previos

​Instala el CLI

​Empezar a usar el CLI

​Obtener ayuda de los comandos

​Comandos principales

​Enlaces

Características

Requisitos previos

Instala el CLI

Empezar a usar el CLI

Obtener ayuda de los comandos

Comandos principales

Enlaces