---
title: "Chatbox: importación y configuración en un clic"
description: "Importa Chatbox desde la página de API Key y verifica API Host, ruta, modelo y clave."
headingIds: {"Importación en un clic":"section-1","Portapapeles y configuración manual":"section-2","Solución de problemas":"section-3"}
---

<aside className="docs-publication" data-pagefind-ignore>

Documentación mantenida por [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Fuentes y correcciones](https://1zheai.com/en/editorial/).

¿Encontraste un error? [Contacta con soporte](mailto:support@1zheai.com) indicando la dirección de la página y una descripción. No envíes claves de API ni credenciales de cuenta.

</aside>
Desde Chatbox 1.15.1 se admiten JSON de proveedor y `chatbox://provider/import`. La versión de escritorio requiere instalarse y ejecutarse una vez. En la versión web o en sistemas sin registro de protocolo, usa la importación desde el portapapeles.

## Importación en un clic

1. Abre **API Key** en la consola, busca la clave que quieras usar y entra en **Herramientas de uso → Chatbox**.
2. Selecciona el modelo de chat disponible para esta clave y pulsa **Abrir Chatbox** para permitir que el navegador abra la aplicación.
3. Confirma la importación en Chatbox y revisa la dirección del proveedor y el modelo. Si ya existe una configuración con el mismo nombre, verifica primero el alcance de la sobrescritura.
4. Envía un mensaje corto y comprueba el modelo y la hora de la solicitud en el registro de llamadas de este sitio.

## Portapapeles y configuración manual

Si la aplicación no se abre, copia **Chatbox JSON** en el mismo panel e impórtalo desde el portapapeles en la gestión de proveedores de la configuración de Chatbox. Antes de compartirlo con otros, debes eliminar `settings.apiKey`.

| Campo | Valor |
| --- | --- |
| Tipo | OpenAI API compatible |
| API Host | `https://1zheai.com` |
| API Path | `/v1/chat/completions` |
| API Key | clave actual |
| Model ID | modelo de chat disponible para la clave actual |

Rellena Host y Path por separado; no añadas `/v1` a ambos campos a la vez. Si no hay modelos, obtén primero la lista de modelos o añádelos manualmente; las capacidades de imágenes, embeddings, llamadas a herramientas, etc., deben validarse por separado; no trates cualquier modelo como modelo de chat.

## Solución de problemas

- La aplicación no aparece: confirma que está instalada y se ha ejecutado, permite el protocolo en el navegador o usa la importación desde el portapapeles.
- 401 tras la importación: comprueba que la clave es válida y que no tiene espacios.
- 404: confirma que la ruta final es `/v1/chat/completions` y que no se ha concatenado dos veces.
- Modelo inexistente: usa el ID exacto de la lista de modelos; no lo deduzcas por el apodo mostrado.

Oficial: [protocolo de importación de configuración ](https://docs.chatboxai.app/guides/providers/import-config), [código fuente del cliente ](https://github.com/chatboxai/chatbox/blob/main/src/renderer/utils/provider-config.ts).

<Note> verificado con la documentación oficial el 2026-10-19. Este sitio ha implementado la generación de configuración y pruebas de regresión del frontend; no se han completado las verificaciones de inferencia real en todos los clientes, sistemas y modelos. Vuelve a verificar tras actualizar el cliente. La conexión personalizada no implica asociación oficial ni recomendación integrada. </Note>

Más: [API Key ](/es/docs/api-keys/), [lista de modelos ](/es/docs/models/), [registro de llamadas ](/es/docs/usage-logs/), [explicación de direcciones ](/es/docs/base-url/).