# Conectar GPT a Cherry Studio > Configura GPT, APIs compatibles con OpenAI, Claude, Gemini o modelos locales en Cherry Studio. Aprende a elegir el proveedor, añadir el modelo y resolver errores 401 y 404. - Canonical HTML: https://omniakey.com/es/blog/cherry-studio-api-setup - Markdown: https://omniakey.com/es/blog/cherry-studio-api-setup.md - Published: 2026-09-17 (updated 2026-09-21) - Author: Kiki, COO at OmniaKey - Language: es - Category: API setup - Reading time: 12 min - All posts: https://omniakey.com/blog/llms.txt --- Si buscas **cómo conectar GPT a Cherry Studio**, normalmente necesitas configurar un proveedor, no leer una lista de funciones. Las cuatro piezas importantes son el protocolo, la API key, la URL base y el ID exacto del modelo. La ruta rápida es: **Ajustes → Servicios de modelos → elegir o añadir proveedor → introducir credenciales y URL → obtener o añadir el modelo → activar → comprobar**. Cherry Studio incluye proveedores para OpenAI, Anthropic, Google Gemini, DeepSeek, Moonshot, Ollama y LM Studio. Para una pasarela, un servidor privado o un servicio compatible con OpenAI, usa un proveedor personalizado. Consulta la [guía oficial de servicios de modelos](https://docs.cherryai.com.cn/pre-basic/providers/providers.md) para comprobar los nombres actuales de la interfaz. ## Antes de empezar Pide estos datos al servicio que vas a usar: |Dato|Significado| |-|-| |Protocolo|OpenAI compatible, Anthropic Messages, Gemini u otro documentado| |API key|Credencial que autoriza la petición| |URL base|Dirección raíz de la API, salvo que se exija un endpoint completo| |ID del modelo|Cadena exacta que acepta la API| La contraseña de una cuenta web no es una API key. Una suscripción de ChatGPT, una cuenta API y una pasarela de terceros son accesos distintos. ## Configurar GPT paso a paso ### 1. Abre Servicios de modelos En Cherry Studio entra en **Ajustes → Servicios de modelos**. Usa el proveedor OpenAI integrado si llamas directamente a OpenAI. Si utilizas una pasarela o un despliegue propio, pulsa **Añadir proveedor** y crea una configuración separada. El proveedor se elige por el **protocolo**, no por la palabra GPT del nombre del modelo. ### 2. Completa los campos |Campo|Qué introducir|Error típico| |-|-|-| |Nombre|Una etiqueta reconocible|Reutilizarla para endpoints distintos| |API key|Solo el valor de la clave|Espacios, comillas o `Bearer`| |Tipo de API|El protocolo indicado por el servicio|Adivinarlo por el nombre del modelo| |Dirección|La URL raíz o la URL completa documentada|Usar la URL del panel o duplicar `/v1`| En un servicio OpenAI compatible, normalmente se introduce la URL raíz y Cherry Studio añade la ruta. Si ves `https://api.example.com` y `https://api.example.com/v1/chat/completions`, la primera suele ser la URL base. Usa la segunda solo si el proveedor lo exige explícitamente. La [guía de proveedor personalizado](https://docs.cherryai.com.cn/pre-basic/providers/zi-ding-yi-fu-wu-shang.md) explica las variantes de endpoint. ### 3. Obtén o añade el modelo Pulsa **Obtener lista de modelos** y añade el modelo con `+`. El ID devuelto por el servicio es la referencia correcta; conserva sus fechas, guiones y prefijos. Si la API no ofrece descubrimiento de modelos, añádelo manualmente. Guardar el proveedor no basta: el modelo debe estar en la lista y el interruptor del proveedor debe estar activado. ### 4. Comprueba una petición mínima Pulsa **Comprobar** y envía: ```text Responde exactamente: conexión correcta ``` Prueba imágenes, herramientas y razonamiento solo después de que el texto básico funcione. ## Otras APIs de terceros Para un gateway OpenAI compatible, elige **Proveedor personalizado → OpenAI**. Para un gateway que ofrece OpenAI Chat, Responses, Anthropic y Gemini desde una dirección, revisa las [instrucciones de NewAPI](https://docs.cherryai.com.cn/pre-basic/providers/newapi.md). Para Ollama, LM Studio o vLLM, usa el proveedor local o un endpoint OpenAI compatible y escribe el nombre real del modelo cargado. ## Lista de modelos vacía y errores Si la lista está vacía, confirma que la API ofrece un endpoint de modelos, elimina rutas duplicadas, usa la dirección de la API en lugar del panel, copia el ID exacto y activa el proveedor. |Error|Primera comprobación| |-|-| |`401`|Clave, protocolo y espacios extra| |`403`|Permisos, saldo o límite de la clave| |`404`|URL raíz, `/v1` duplicado o endpoint equivocado| |`400`|Parámetros personalizados; prueba texto simple| |`model not found`|ID real del modelo y lista local de Cherry Studio| |Texto funciona, imágenes no|Capacidad del modelo y protocolo| Modifica una sola variable cada vez: un proveedor, un modelo y una petición corta. ## Comparar modelos y usar OmniaKey Puedes cambiar de modelo desde el selector de conversación o seleccionar varios para enviar la misma pregunta. Cada modelo genera una petición independiente; no es una votación automática y aumentan las solicitudes, el coste y los datos enviados. La [guía oficial de comparación](https://docs.cherryai.com.cn/advanced-basic/chat/model-compare-branches.md) recomienda definir criterios antes de comparar. Si prefieres un único punto de entrada para GPT, Claude, Gemini y otros modelos, configura OmniaKey como proveedor OpenAI compatible: 1. Crea una clave dedicada en la [página de API Keys](https://omniakey.com/es/dashboard/tokens). 2. En Cherry Studio abre **Ajustes → Servicios de modelos → Añadir proveedor**. 3. Usa la [guía rápida de OmniaKey](https://docs.omniakey.com/es/quick-start) para introducir la URL y la clave. 4. Añade un ID del [catálogo actual](https://omniakey.com/es/models) y comprueba una petición. 5. Activa el proveedor, lanza una comprobación corta y confirma la petición en [Uso](https://omniakey.com/es/dashboard/usage). El catálogo y las capacidades cambian; usa siempre los IDs actuales. Una ruta compatible con OpenAI no garantiza que todas las funciones de visión o herramientas sean idénticas. La misma clave funciona en otras herramientas; consulta las guías [Modelo personalizado en WorkBuddy](https://omniakey.com/es/blog/workbuddy-custom-model-setup), [Clave API personalizada en Cline](https://omniakey.com/es/blog/cline-custom-api-key) y [Usa Claude Code con OmniaKey](https://omniakey.com/es/blog/claude-code-setup). ## Preguntas frecuentes ### ¿Puedo usar cualquier URL de API? Solo si el servicio documenta un protocolo compatible, autenticación y un ID de modelo. Una URL sin formato de petición no es suficiente. ### ¿Debo introducir la URL raíz o `/chat/completions`? Sigue la documentación del proveedor. Lo normal es introducir la URL raíz y dejar que Cherry Studio añada la ruta; usa una ruta completa solo si el proveedor la exige. ### ¿Una suscripción de ChatGPT sirve como API key? No introduzcas credenciales de acceso web en el campo de API. Cherry Studio necesita permisos de API o una credencial de una pasarela compatible. ### ¿Por qué funciona el chat pero no el agente? La respuesta de texto solo confirma la ruta básica. Comprueba por separado el modelo, el protocolo y la capacidad de herramientas. ## Fuentes consultadas - [Cherry Studio: Ajustes del servicio de modelos](https://docs.cherryai.com.cn/pre-basic/providers/providers.md) - [Cherry Studio: Proveedor personalizado](https://docs.cherryai.com.cn/pre-basic/providers/zi-ding-yi-fu-wu-shang.md) - [Cherry Studio: NewAPI](https://docs.cherryai.com.cn/pre-basic/providers/newapi.md) - [Cherry Studio: Comparación de varios modelos y ramas de mensajes](https://docs.cherryai.com.cn/advanced-basic/chat/model-compare-branches.md) Los valores técnicos como los ID de modelo, las capacidades del proveedor y las direcciones de petición pueden cambiar; compruébalos al configurar.