> ## 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. # Referencia de comandos > Referencia de los comandos de la CLI de CometAPI, incluidos chat, models, model info, run, balance, account, stats, tokens, logs, tasks, doctor, config y repl. Usa `cometapi -h` o `cometapi -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 ` | 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](/es/libraries/cli/configuration) para más detalles. ## Chat Envía un único mensaje o inicia el chat REPL de varios turnos. ```bash theme={null} 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. ```bash theme={null} 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. ```bash theme={null} 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. ```bash theme={null} 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. ```bash theme={null} 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. ```bash theme={null} cometapi account cometapi account --json ``` ## Estadísticas Muestra estadísticas de uso. Requiere un token de acceso. ```bash theme={null} cometapi stats cometapi stats --json ``` ## Tokens Lista y busca API keys. Requiere un token de acceso. ```bash theme={null} 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. ```bash theme={null} 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. ```bash theme={null} 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. ```bash theme={null} cometapi doctor cometapi doctor --json ``` ## Config Administra la configuración de la CLI almacenada en `~/.config/cometapi/config.toml`. ```bash theme={null} 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](/es/libraries/cli/configuration) para ver todas las claves disponibles. ## Init Ejecuta el asistente de configuración interactivo: ```bash theme={null} cometapi init ``` ## Repl Inicia una shell de comandos interactiva completa: ```bash theme={null} cometapi repl ``` ## Output formats La mayoría de los comandos de datos admiten `--json` o `--format`: ```bash theme={null} 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 |