Cherry Studio

Cherry Studio puede conectarse a HiAPI mediante un proveedor personalizado. Un mismo proveedor puede tener tres endpoints a la vez —OpenAI, Anthropic y OpenAI Responses—, cada uno para un protocolo distinto, y tú eliges el endpoint que corresponde al protocolo que admite un modelo. Los pasos siguientes usan claude-opus-5-5, gpt-6-astra y deepseek-v4.1-flash como ejemplos; este tutorial se verificó en Cherry Studio 2.1.7.

1. Prepara una HiAPI API key

Prepara una clave como se describe en Obtener una API key, haz clic en el icono de copiar junto a la clave y copia la HiAPI API key completa para rellenarla en Cherry Studio más abajo.

2. Elige el protocolo

Los modelos de ejemplo de esta página se han probado todos con la tabla de arriba. Para otro modelo, elige primero el endpoint en la tabla y envía un mensaje para probarlo; si obtienes 400 does not support this endpoint, cambia a otro endpoint.

3. Añade el proveedor

3.1 Dónde empezar

Haz clic en Settings → Model Providers → Add Provider (设置 → 模型服务 → 添加提供商).

3.2 Rellena la misma dirección en los tres endpoints

Rellena https://api.hiapi.ai en los tres endpoints sin /v1; Cherry Studio añade la ruta por su cuenta. Esto es distinto de otras herramientas.

3.3 Comprueba las rutas reales de las solicitudes

Si no coinciden: cuando veas /v1/v1/..., cambia el campo a https://api.hiapi.ai; cuando falte /v1, cámbialo a https://api.hiapi.ai/v1.

4. Añade modelos y define su protocolo

Después de añadir un nombre de modelo, haz clic en el icono de lápiz del modelo para abrir Edit Model (编辑模型), elige el Chat protocol (对话协议) que corresponda al protocolo del modelo y define Max output tokens (最大输出 Token).

4.1 Ejemplos de protocolo

Con los tres modelos de abajo, añade primero los nombres de modelo:

claude-opus-5-5
gpt-6-astra
deepseek-v4.1-flash

Luego haz clic en el icono de lápiz de un modelo → Edit Model (编辑模型) y elige el protocolo de chat así:

5. Verificar

Después de cambiar los ajustes, inicia un chat nuevo para probar; los chats antiguos guardan en caché los parámetros.

5.1 Chat

Inicia un chat nuevo y envía “Hola, preséntate en una frase.” con cada modelo configurado; una respuesta normal significa que la conexión funciona.

5.2 Llamadas a herramientas

Configura MCP como se describe en la sección de Cherry Studio de la guía de configuración de MCP (un servidor integrado o uno instalado desde el marketplace), luego crea tool-call-test.txt en una carpeta a la que MCP tenga acceso permitido, escribe una línea hello hiapi y guárdalo. Después envía “Usa la herramienta de lectura de archivos una sola vez. Lee todo el contenido de tool-call-test.txt y devuélvelo exactamente tal cual. No modifiques el archivo, no leas ningún otro archivo y no adivines el contenido a partir del nombre del archivo.” Aparece una llamada a herramienta que devuelve hello hiapi.

6. Solución de problemas

Aquí solo se recogen los problemas propios de Cherry Studio. Para errores comunes como 401, 404 y 429, consulta Errores comunes.