---
title: "Integración con Cherry Studio"
description: "Añade 1折AI como proveedor personalizado en Cherry Studio, elige el endpoint Anthropic u OpenAI, e introduce la dirección raíz, la clave API y los modelos."
headingIds: {"Importación con un clic":"section-1","Configuración":"section-2","Elegir entre los endpoints Anthropic u OpenAI":"section-3","Preguntas frecuentes":"section-4"}
---

<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>
Cherry Studio es un cliente de conversación con IA para escritorio que permite añadir 1折AI como un proveedor personalizado.

## Importación con un clic

En la consola, en **Clave API → Herramientas de uso → Cherry Studio**, selecciona el protocolo Anthropic u OpenAI y haz clic en **Abrir Cherry Studio**. Tras confirmar la importación en la aplicación, obtén los modelos, habilita el proveedor y realiza una prueba. Si ya existe una configuración con el mismo nombre, revisa el aviso de sobrescritura. El enlace de importación contiene la clave completa; no lo reenvíes.

El navegador no puede confirmar si la aplicación está instalada. Si no se abre, instala y ejecuta una vez el cliente, o utiliza los pasos manuales siguientes. El formato del protocolo se ha verificado con la implementación oficial; la inferencia real debe validarse según la versión y el modelo utilizados.

## Configuración

<Steps>
<Step title="Añadir proveedor">

Ajustes (icono de engranaje) → **Servicios de modelos** → **+ Añadir proveedor** al final de la lista.

</Step>
<Step title="Rellenar información">

| Campo | Qué introducir |
|---|---|
| Nombre del proveedor | `1折AI` |
| Clave API | `sk-你的Key` |
| Endpoint | Elige **Anthropic** (recomendado) u **OpenAI** |
| Dirección API | `https://1zheai.com` |

En la dirección API introduce solo la dirección raíz; Cherry Studio añadirá automáticamente `/v1/...` según el protocolo elegido. No pegues rutas completas como `/v1/messages` o `/v1/chat/completions`, ni añadas `#` al final (un final `#` indica que no se añadirán más rutas automáticamente).

</Step>
<Step title="Añadir modelo">

Haz clic en **Obtener lista de modelos** y añade los modelos que vayas a usar de la lista devuelta; o haz clic en **+** e introduce manualmente el ID del modelo, por ejemplo `claude-sonnet-5-5`. Solo los modelos añadidos a la lista aparecerán en el selector de modelos de la conversación.

</Step>
<Step title="Habilitar y probar">

Activa el interruptor de habilitación en la esquina superior derecha de la página del proveedor, vuelve a la interfaz de conversación y envía un mensaje con un modelo de 1折AI.

</Step>
</Steps>

## Elegir entre los endpoints Anthropic u OpenAI

| Endpoint | Adecuado para |
|---|---|
| Anthropic | Quiere usar capacidades nativas de Claude como extended thinking; las restricciones de protocolo del Agente se rigen por la versión actual |
| OpenAI | Está acostumbrado al formato de OpenAI o quiere gestionar de forma unificada otros servicios compatibles con OpenAI |

Ambos endpoints utilizan la misma clave API (API key) y el mismo conjunto de IDs de modelo.

## Preguntas frecuentes

<AccordionGroup>
<Accordion title="¿Fallo al obtener la lista de modelos?">

Primero comprueba si la clave API tiene espacios sobrantes; después confirma que la dirección API es `https://1zheai.com` y que no contiene rutas añadidas. Si no se pueden obtener los modelos, puedes seguir usándolos introduciendo manualmente los IDs de modelo.

</Accordion>
<Accordion title="¿La conversación devuelve 404?">

La dirección API se escribió como una ruta completa, o se añadió `#` al final. Cámbiala por la dirección raíz `https://1zheai.com`.

</Accordion>
</AccordionGroup>
