> ## 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.

# CometAPI CLI

> Instala y usa la interfaz de línea de comandos de CometAPI para chatear con modelos, explorar metadatos de modelos, ejecutar solicitudes multiprotocolo, comprobar el saldo e inspeccionar el uso desde la terminal.

[CometAPI CLI](https://pypi.org/project/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](https://pypi.org/project/cometapi-cli/) 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.

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

## 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](https://www.cometapi.com/console/token)

## Instala el CLI

Instala el paquete desde PyPI:

<CodeGroup>
  ```bash pip theme={null}
  pip install cometapi-cli
  ```

  ```bash pipx theme={null}
  pipx install cometapi-cli
  ```

  ```bash uv theme={null}
  uv tool install cometapi-cli
  ```
</CodeGroup>

Verifica el comando instalado:

```bash theme={null}
cometapi --version
cometapi -h
```

## Empezar a usar el CLI

<Steps>
  <Step title="Configura las credenciales">
    Ejecuta el asistente de configuración:

    ```bash theme={null}
    cometapi init
    ```

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

    ```bash theme={null}
    export COMETAPI_KEY="your-api-key"
    ```

    El valor opcional `COMETAPI_ACCESS_TOKEN` solo es necesario para los comandos account, stats, tokens, logs y tasks.
  </Step>

  <Step title="Chatea con un modelo">
    Envía un solo mensaje de chat:

    ```bash theme={null}
    cometapi chat "Explain CometAPI in one sentence."
    ```

    Ejecuta `cometapi chat` sin un mensaje para iniciar el REPL de chat.
  </Step>

  <Step title="Explora modelos">
    Busca en el catálogo público de modelos:

    ```bash theme={null}
    cometapi models --search gpt --limit 10
    ```

    Filtra por metadatos del catálogo:

    ```bash theme={null}
    cometapi models --provider openai --type chat --limit 10
    cometapi models --feature image --endpoint responses --json
    ```
  </Step>

  <Step title="Inspecciona un modelo">
    Muestra los metadatos detallados de un modelo:

    ```bash theme={null}
    cometapi model info your-model-id
    ```

    Muestra el payload de detalle en bruto:

    ```bash theme={null}
    cometapi model info your-model-id --json
    ```
  </Step>

  <Step title="Ejecuta una solicitud multiprotocolo">
    Envía una solicitud puntual a través del endpoint de chat predeterminado:

    ```bash theme={null}
    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:

    ```bash theme={null}
    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
    ```
  </Step>
</Steps>

## 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:

```bash theme={null}
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                                     |

## Enlaces

* [Paquete de PyPI](https://pypi.org/project/cometapi-cli/)
* [Referencia de comandos](/es/libraries/cli/commands)
* [Guía de configuración](/es/libraries/cli/configuration)