> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Uso de APIMart en ChatBox

> Guía detallada sobre cómo configurar y usar el servicio de API de APIMart en el cliente de escritorio ChatBox. Esta guía le ayudará a configurar la API de APIMart en ChatBox para acceder a una amplia variedad de recursos de modelos de IA.

## Requisitos previos

Antes de comenzar, asegúrese de:

1. **Tener ChatBox instalado**
   Descargue e instale la versión adecuada para su sistema operativo desde [ChatBox GitHub](https://github.com/Bin-Huang/chatbox) o visite el [sitio web oficial de ChatBox](https://chatboxai.app/)

2. **Haber obtenido una clave de API de APIMart**
   Acceda a la [Consola de APIMart](https://apimart.ai/keys) para obtener su clave de API (comienza con `sk-`)

<Note>
  **Consejo:** Si aún no tiene una cuenta en APIMart, regístrese primero en [APIMart](https://apimart.ai) y obtenga una clave de API.
</Note>

## Paso 1: Iniciar ChatBox y comenzar la configuración

Al iniciar ChatBox por primera vez o al añadir un nuevo proveedor de IA:

1. Inicie la aplicación ChatBox
2. Si es la primera vez, aparecerá automáticamente un asistente de configuración
3. Haga clic en el botón **"Use your own API Key or local model"**
4. Si ya está configurado, haga clic en el icono **⚙️ Configuración** en la esquina inferior izquierda, o use el atajo `Ctrl+,` (Windows/Linux) / `Cmd+,` (macOS)

<Frame>
  <img src="https://mintcdn.com/apicore/60dm1rHMQir4d9rs/images/integrations/chatbox/main-interface.png?fit=max&auto=format&n=60dm1rHMQir4d9rs&q=85&s=97330aedf8be26446c3a8d9e4386f0bd" alt="ChatBox Configuration Wizard" width="1023" height="768" data-path="images/integrations/chatbox/main-interface.png" />
</Frame>

<caption>*Asistente de configuración de ChatBox, seleccione usar su propia API Key*</caption>

## Paso 2: Configurar la API de APIMart

### 2.1 Seleccionar el proveedor de modelos de IA

En la página de configuración:

1. Busque la opción **AI Provider**
2. Seleccione **OpenAI API** (para los modelos de la serie GPT), **Claude API** (para los modelos de la serie Claude) o **Gemini API** (para los modelos de la serie Gemini) del menú desplegable

<Frame>
  <img src="https://mintcdn.com/apicore/60dm1rHMQir4d9rs/images/integrations/chatbox/settings-page.png?fit=max&auto=format&n=60dm1rHMQir4d9rs&q=85&s=f53a32eb9ce38bd30aa3d631a6582a88" alt="ChatBox Settings Page" width="1023" height="768" data-path="images/integrations/chatbox/settings-page.png" />
</Frame>

<caption>*Página de configuración de ChatBox, seleccione OpenAI API como proveedor*</caption>

### 2.2 Configurar la información de la API

Después de seleccionar OpenAI API, complete la siguiente configuración:

| Campo                         | Valor                                          |
| ----------------------------- | ---------------------------------------------- |
| **API Key**                   | Su clave de API de APIMart (`sk-xxxxxxxxxxxx`) |
| **API Host** o **API Domain** | `https://api.apimart.ai`                       |

<Frame>
  <img src="https://mintcdn.com/apicore/60dm1rHMQir4d9rs/images/integrations/chatbox/api-config.png?fit=max&auto=format&n=60dm1rHMQir4d9rs&q=85&s=8fe2f0c256c2f0db5ee3a5226b833509" alt="API Configuration" width="1023" height="768" data-path="images/integrations/chatbox/api-config.png" />
</Frame>

Después de seleccionar Claude API, complete la siguiente configuración:

| Campo                         | Valor                                          |
| ----------------------------- | ---------------------------------------------- |
| **API Key**                   | Su clave de API de APIMart (`sk-xxxxxxxxxxxx`) |
| **API Host** o **API Domain** | `https://api.apimart.ai/v1`                    |

<Frame>
  <img src="https://mintcdn.com/apicore/BIebF3Cd34siboYG/images/integrations/chatbox/claude.png?fit=max&auto=format&n=BIebF3Cd34siboYG&q=85&s=cbe2d868a9b163e2429ededba1bc7586" alt="Claude Model" width="1023" height="768" data-path="images/integrations/chatbox/claude.png" />
</Frame>

Después de seleccionar Gemini API, complete la siguiente configuración:

| Campo                         | Valor                                          |
| ----------------------------- | ---------------------------------------------- |
| **API Key**                   | Su clave de API de APIMart (`sk-xxxxxxxxxxxx`) |
| **API Host** o **API Domain** | `https://api.apimart.ai/`                      |

<caption>*Complete la API Key y el API Host de APIMart*</caption>

<Frame>
  <img src="https://mintcdn.com/apicore/BIebF3Cd34siboYG/images/integrations/chatbox/Gemini.png?fit=max&auto=format&n=BIebF3Cd34siboYG&q=85&s=779122ac703c90f3ed009aa8dae47370" alt="Gemini" width="1023" height="768" data-path="images/integrations/chatbox/Gemini.png" />
</Frame>

<Warning>
  **Importante:**

  * Cuando use OpenAI API, el API Host debe ser `https://api.apimart.ai` (sin el sufijo `/v1`)
  * Cuando use Claude API, el API Host debe ser `https://api.apimart.ai/v1` (con el sufijo `/v1`)
  * Cuando use Gemini API, el API Host debe ser `https://api.apimart.ai/` (sin el sufijo `/v1`)
  * La API Key debe obtenerse desde la consola de APIMart y comenzar con `sk-`
  * Asegúrese de que su clave de API tenga saldo suficiente
</Warning>

### 2.3 Seleccionar modelo

Tras la configuración, seleccione el modelo que desea usar desde el menú desplegable **Model**:

**Modelos recomendados:**

| Nombre del modelo | ID del modelo                  | Características           |
| ----------------- | ------------------------------ | ------------------------- |
| GPT-5             | `gpt-5`                        | El más reciente y potente |
| GPT-4o            | `gpt-4o` o `chatgpt-4o-latest` | Chat de alta calidad      |
| GPT-4o Mini       | `gpt-4o-mini`                  | Rápido y económico        |
| Claude Sonnet 4.5 | `claude-sonnet-4-5-20250929`   | Excelente para código     |
| Claude Haiku 4.5  | `claude-haiku-4-5-20251001`    | Respuesta rápida          |
| Gemini 2.0 Flash  | `gemini-2.0-flash-exp`         | Soporte multimodal        |

<Warning>
  **Instrucciones especiales para usar modelos Claude:**

  Si elige usar modelos Claude (como `claude-sonnet-4-5-20250929` o `claude-haiku-4-5-20251001`), necesita la siguiente configuración adicional:

  1. **Cambiar al proveedor Claude API**:
     * Cambie el **AI Provider** a **Claude API** en la configuración
     * Mantenga el API Host como `https://api.apimart.ai/v1`
     * Use su clave de API de APIMart (`sk-xxxxxxxxxxxx`)

  2. **O añadir encabezados de solicitud personalizados** (si usa el proveedor OpenAI API):
     * Algunas versiones de ChatBox admiten añadir Headers personalizados
     * Añada el encabezado de solicitud en la configuración avanzada: `anthropic-version: 2023-06-01`

  **Enfoque recomendado:** Use **OpenAI API** para los modelos de la serie GPT, **Claude API** para los modelos de la serie Claude y **Gemini API** para los modelos de la serie Gemini.
</Warning>

<caption>*Seleccione el modelo de IA deseado de la lista*</caption>

<Tip>
  **Recomendaciones de rendimiento:**

  * 💰 **Económicos:** `gpt-4o-mini`, `claude-haiku-4-5-20251001`
  * 🚀 **Alto rendimiento:** `gpt-5`, `gpt-4o`, `claude-sonnet-4-5-20250929`
  * ⚡ **Respuesta rápida:** `gemini-2.0-flash-exp`, `gpt-4o-mini`
</Tip>

## Paso 3: Comenzar a usar

Tras la configuración, puede comenzar a usar ChatBox para conversar con la IA:

1. Regrese a la interfaz principal
2. Escriba su pregunta o solicitud en el cuadro de entrada
3. Pulse `Enter` o haga clic en el botón de enviar
4. La IA generará una respuesta usando los modelos de APIMart

<Frame>
  <img src="https://mintcdn.com/apicore/60dm1rHMQir4d9rs/images/integrations/chatbox/chat-interface.png?fit=max&auto=format&n=60dm1rHMQir4d9rs&q=85&s=3bdd5a9f07e4d0610520c71d0ff2d599" alt="Chat Interface" width="1023" height="768" data-path="images/integrations/chatbox/chat-interface.png" />
</Frame>

<caption>*Interfaz de chat de ChatBox, comience a conversar con la IA*</caption>

### Ajustar parámetros del modelo (opcional)

Puede ajustar los siguientes parámetros según sea necesario:

| Parámetro       | Descripción                           | Valor recomendado              |
| --------------- | ------------------------------------- | ------------------------------ |
| **Temperature** | Controla la aleatoriedad de la salida | 0.7 (creativo) / 0.3 (preciso) |
| **Max Tokens**  | Longitud máxima de la salida          | 2000-4000                      |
| **Top P**       | Parámetro de muestreo de núcleo       | 0.9                            |

## Características avanzadas

### Gestión de múltiples sesiones

ChatBox admite la creación de múltiples sesiones de conversación:

1. Haga clic en el botón **New Chat**
2. Cree sesiones independientes para diferentes tareas
3. Cambie entre conversaciones en la lista de sesiones de la izquierda

### Guardar y exportar conversaciones

1. Haga clic derecho en una sesión de conversación
2. Seleccione la opción **Export**
3. Exporte como Markdown, JSON u otros formatos

### Uso de plantillas de prompts

1. Busque los ajustes **Prompts** en el menú de configuración
2. Guarde plantillas de prompts de uso frecuente
3. Invoque rápidamente prompts predefinidos en las conversaciones

## Preguntas frecuentes

### Q1: ¿No se puede conectar al servicio de APIMart?

**Solución:**

1. **Verifique el API Host**:
   * Asegúrese de que sea `https://api.apimart.ai`
   * No añada `/v1` u otras rutas

2. **Verifique la API Key**:
   * Confirme que la API Key comience con `sk-`
   * Compruebe si la clave es válida en la [Consola de APIMart](https://apimart.ai/keys)

3. **Verifique la conexión de red**:
   * Asegúrese de poder acceder a `https://api.apimart.ai`
   * Puede que necesite configurar un proxy si está en China

### Q2: ¿Los modelos de APIMart no aparecen en la lista de modelos?

**Solución:**

1. **Introduzca manualmente el nombre del modelo**:
   * Escriba directamente el ID del modelo en el cuadro de entrada del modelo
   * Por ejemplo: `gpt-4o`, `gpt-4o-mini`, `claude-sonnet-4-5-20250929`

2. **Actualice la lista de modelos**:
   * Reinicie la aplicación ChatBox
   * Vuelva a configurar la información de la API

### Q3: ¿Mensajes de error durante la conversación?

**Errores comunes y soluciones:**

| Mensaje de error            | Causa                                       | Solución                                                 |
| --------------------------- | ------------------------------------------- | -------------------------------------------------------- |
| `401 Unauthorized`          | API Key inválida o expirada                 | Vuelva a obtener la API Key y actualice la configuración |
| `429 Too Many Requests`     | Se excedió el límite de tasa de solicitudes | Espere un momento y vuelva a intentarlo                  |
| `500 Internal Server Error` | Problema temporal del servidor              | Espere unos minutos y vuelva a intentarlo                |
| `insufficient_quota`        | Saldo de cuenta insuficiente                | Recargue en la consola                                   |

### Q4: ¿Cómo ver el uso y los costos de la API?

Acceda a la [Consola de APIMart](https://apimart.ai/overview) para ver:

* 📊 Estadísticas de llamadas a la API
* 💰 Detalles de costos
* 📈 Gráficos de tendencias de uso
* 🔍 Registros detallados de solicitudes

### Q5: ¿Qué plataformas admite ChatBox?

ChatBox admite múltiples plataformas:

* 🪟 **Windows** - Windows 10/11
* 🍎 **macOS** - macOS 10.15+
* 🐧 **Linux** - Principales distribuciones
* 🌐 **Web** - Versión para navegador

## Consejos de uso

### 1. Atajos de teclado

Aproveche los atajos de teclado de ChatBox para ganar eficiencia:

| Atajo              | Función                  |
| ------------------ | ------------------------ |
| `Ctrl/Cmd + Enter` | Enviar mensaje           |
| `Ctrl/Cmd + N`     | Nuevo chat               |
| `Ctrl/Cmd + K`     | Buscar conversaciones    |
| `Ctrl/Cmd + ,`     | Abrir configuración      |
| `Ctrl/Cmd + /`     | Mostrar ayuda de teclado |

### 2. Optimizar prompts

Escriba mejores prompts para obtener mejores respuestas:

**❌ Prompt deficiente:**

```
Write code for me
```

**✅ Buen prompt:**

```
Please help me write a Python function that:
1. Takes a list of strings as input
2. Filters out strings shorter than 3 characters
3. Returns results sorted alphabetically
Please include detailed comments and usage examples
```

### 3. Aprovechar el historial de conversaciones

ChatBox guarda el historial de conversaciones:

* La IA recuerda el contexto de la sesión actual
* Puede seguir preguntando basándose en respuestas anteriores
* Adecuado para discusiones profundas e iteraciones

### 4. Cambiar de modelo

Cambie al modelo adecuado para diferentes tareas:

* **Tareas de escritura** - Use `gpt-4o` o `claude-sonnet-4-5`
* **Tareas de programación** - Use `claude-sonnet-4-5`
* **Preguntas y respuestas rápidas** - Use `gpt-4o-mini`
* **Multimodal** - Use `gemini-2.0-flash-exp`

## Características

Usando ChatBox + APIMart, puede:

* 💬 **Conversaciones fluidas** - Salida en streaming en tiempo real para una experiencia más fluida
* 🎯 **Gestión de múltiples sesiones** - Gestione varias conversaciones independientes simultáneamente
* 💾 **Almacenamiento local** - Registros de conversación guardados localmente para proteger la privacidad
* 📤 **Exportar conversaciones** - Admite exportación en múltiples formatos
* 🎨 **Interfaz limpia** - Interfaz de usuario simple y atractiva
* 🔒 **Código abierto y gratuito** - Completamente de código abierto y gratuito
* 🌍 **Multiplataforma** - Admite Windows, macOS, Linux
* 🚀 **Excelente rendimiento** - Aplicación ligera, funciona sin problemas

## Soporte y ayuda

Si encuentra algún problema:

* 📚 [Documentación de APIMart](https://docs.apimart.ai)
* 📚 [ChatBox GitHub](https://github.com/Bin-Huang/chatbox)
* 💬 [Comunidad de Discord](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @APIMart\_](https://x.com/APIMart_)
* 📧 Soporte técnico: [zhihong@apimart.ai](mailto:zhihong@apimart.ai)

***

<Card title="Comience a usar APIMart" icon="rocket" href="https://apimart.ai">
  ¡Regístrese en APIMart ahora, obtenga su clave de API y comience su viaje con IA en ChatBox!
</Card>