Conectar GPT a Cherry Studio
Elige el protocolo correcto, introduce la URL base y el ID exacto del modelo, y comprueba primero una petición corta.
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 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 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:
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. 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 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:
- Crea una clave dedicada en la página de API Keys.
- En Cherry Studio abre Ajustes → Servicios de modelos → Añadir proveedor.
- Usa la guía rápida de OmniaKey para introducir la URL y la clave.
- Añade un ID del catálogo actual y comprueba una petición.
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.
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.
¿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.