Cherry Studio
Conecte Cherry Studio a RunAPI y verifique un chat.
Conecte Cherry Studio a RunAPI con un proveedor OpenAI personalizado. Cree una Clave de API estándar de RunAPI en la Guía de Autenticación antes de continuar.
Instalar Cherry Studio
Instale la aplicación de escritorio siguiendo la guía de descarga oficial de Cherry Studio y luego abra su configuración.
Agregar el proveedor de RunAPI
- Abre Settings -> Model Services -> + Add.
- Establece el nombre del proveedor en
RunAPIy Provider type en OpenAI. - Ingresa tu Clave de API de RunAPI y establece la dirección de la API en
https://runapi.ai/v1. - Agrega un identificador de modelo exacto del Catálogo de modelos, habilita el proveedor y guarda.
Dado que el tipo de proveedor es OpenAI, este campo utiliza la URL base compatible con OpenAI de RunAPI,
que incluye /v1. Cherry Studio añade
/chat/completions para una solicitud de Chat Completions, por lo que no pegue
la URL completa de la operación en el campo de dirección de la API.
Seleccionar un modelo
Los proveedores personalizados dependen de los modelos que usted agregue. Si el selector está vacío, vuelva al área de administración de modelos del proveedor y agregue un identificador exacto de RunAPI manualmente. Agregar un modelo no otorga capacidades que el modelo no admite.
Ejecutar la verificación de conexión
Ejecute Verificación de conexión con el modelo guardado. Esto envía una solicitud al modelo en lugar de limitarse a validar el formato de la clave. Una verificación exitosa confirma que la URL del proveedor, la clave y el modelo seleccionado funcionan correctamente juntos.
Verificar la conexión
Inicie un nuevo chat, seleccione el proveedor y el modelo de RunAPI, y envíe Reply
with the word connected. Una respuesta completa o en streaming normal confirma que el chat activo está usando RunAPI.
Solución de problemas
- El selector de modelos está vacío: agrega el identificador de modelo exacto en el área de gestión de modelos del proveedor personalizado y confirma que el proveedor está habilitado.
- La verificación de conexión falla: confirma que se ha seleccionado un modelo, reemplaza la clave por una clave estándar válida y vuelve a intentarlo.
- La solicitud devuelve
404: usahttps://runapi.ai/v1como dirección de la API; no añadas/chat/completionsmanualmente. - El texto funciona pero la visión o las herramientas fallan: elige un modelo que declare la capacidad requerida en el Catálogo de modelos.
Para el comportamiento de protocolo compartido, use el Inicio rápido de la API LLM. Para los campos de solicitud y respuesta, use la Referencia de la API de Chat Completions.