> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Guía de configuración de modelos personalizados de Cherry Studio

> Platform API guide - Ace Data Cloud

## 1. Obtener la API Key

Abre la [lista de aplicaciones de Ace Data Cloud](https://platform.acedata.cloud/console/applications), entra en una aplicación disponible y copia la API Key.

![Obtener la API Key de Ace Data Cloud](https://cdn.acedata.cloud/dvc3cg.jpg)

## 2. Añadir Provider

Abre Cherry Studio, entra en **Configuración → Servicios de modelos → Añadir proveedor**, y completa:

| Campo | Valor |
| - | - |
| Nombre del proveedor | `Ace Data Cloud` |
| Tipo de proveedor | `OpenAI` |
| API Key | La API Key que acabas de copiar |
| Dirección de API | `https://api.acedata.cloud` |

![Interfaz de configuración para añadir el Provider de Ace Data Cloud en Cherry Studio](https://cdn.acedata.cloud/b67a927eae62.png)

Cherry Studio completará automáticamente `/v1/chat/completions` para el tipo OpenAI. Al utilizar la entrada general, no añadas `#` al final de la dirección, ni es necesario crear múltiples Providers según la familia de modelos.

## 3. Añadir y habilitar modelos

1. Haz clic en **Obtener lista de modelos**; si la versión actual no admite la obtención automática, ve al [catálogo de modelos](https://platform.acedata.cloud/models) para consultarlo y luego añade manualmente el nombre del modelo objetivo, por ejemplo, `claude-opus-5`, `gpt-6-sol`.
2. Haz clic en el botón de comprobación junto a la API Key para verificar la conexión.
3. Activa el interruptor **Habilitar** del Provider.
4. Selecciona el modelo recién añadido en el selector de modelos de conversación.

![Provider y lista de modelos de Cherry Studio](https://cdn.acedata.cloud/149de1d088bf.png)

> Después de completar la obtención o la adición manual de modelos, activa el interruptor del Provider en la esquina superior derecha.

Envía `Reply only OK` y verifica la llamada en el [historial de uso](https://platform.acedata.cloud/console/usages). Para un 401, comprueba la Key; si el modelo no se muestra, comprueba si el Provider está habilitado; para un 404, comprueba si el nombre del modelo introducido manualmente coincide exactamente con el `id` del catálogo.

## Acerca de GPT Image 2

El Provider de chat personalizado normal de Cherry Studio no puede llamar directamente a la Images API. La generación y edición de `gpt-image-2` deben usar las interfaces dedicadas de Ace Data Cloud:

* [Generación de imágenes de GPT Image 2](https://platform.acedata.cloud/documents/openai-images-generations)
* [Edición de imágenes de GPT Image 2](https://platform.acedata.cloud/documents/openai-images-edits)

No introduzcas `/openai/images/generations` en el Provider de chat.

## Referencias oficiales

* [Cherry Studio](https://cherry-ai.com/)
* [Proveedor de servicios personalizado](https://docs.cherry-ai.com/pre-basic/providers/zi-ding-yi-fu-wu-shang)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.