> ## 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.

# Usar Ace Data Cloud en AnythingLLM

> Platform API guide - Ace Data Cloud

[AnythingLLM](https://anythingllm.com/) es un cliente de código abierto posicionado como «documentos → ChatGPT privado», cuyo concepto central es el **Workspace**: cada Workspace es un conjunto de documentos, un conjunto de usuarios y un conjunto de herramientas de Agent, aislados de forma independiente. Está diseñado específicamente para conversaciones con documentos y ofrece dos modalidades: App de escritorio y Docker. En **LLM Provider**, incluye [OpenAI (Generic)](https://docs.anythingllm.com/setup/llm-configuration/cloud/openai-generic), donde se puede completar una Base URL personalizada, por lo que es posible dirigir directamente el modelo de conversación a Ace Data Cloud. Este artículo presenta el proceso de configuración.

## Proceso de solicitud

Para integrar Ace Data Cloud en AnythingLLM, primero ve a la [consola de Ace Data Cloud](https://platform.acedata.cloud/console/applications), obtén tu API Token y guárdalo como respaldo.

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

Si aún no has iniciado sesión o no te has registrado, se te redirigirá automáticamente a la página de inicio de sesión para invitarte a registrarte e iniciar sesión; después de iniciar sesión o registrarte, volverás automáticamente a la página actual.

En la primera solicitud se otorgará una cuota gratuita, con la que puedes probar gratuitamente los servicios de modelos de Ace Data Cloud.

## Descargar AnythingLLM

Para uso personal puedes descargar la [versión de escritorio](https://anythingllm.com/download), con la base de datos vectorial (LanceDB) ejecutándose localmente, la búsqueda de documentos completamente sin conexión y conexión a Internet únicamente al llamar al modelo; para escenarios de equipos con múltiples usuarios, usa el [despliegue con Docker](https://docs.anythingllm.com/installation-docker/overview).

## Configurar el modelo de conversación

Inicia AnythingLLM, entra en **Settings → LLM Preference** y selecciona **OpenAI (Generic)** como Provider (no selecciones el OpenAI normal, que apunta de forma fija a `api.openai.com` y no tiene Base URL personalizada). Consulta la documentación oficial en [OpenAI (Generic) LLM Provider](https://docs.anythingllm.com/setup/llm-configuration/cloud/openai-generic).

| Campo | Valor | Descripción |
| - | - | - |
| Base URL | `https://api.acedata.cloud/v1` | **Debe terminar en `/v1`** |
| API Key | Tu Token de Ace Data Cloud | El Token copiado desde la consola |
| Selected Model | ID del modelo actual | Prioriza la lista cargada automáticamente desde `/models`; si no se devuelve, consulta según el método anterior y complétalo manualmente |
| Model context window | Según el modelo seleccionado | Lee el límite de contexto desde el catálogo del modelo actual; no copies los valores de otros modelos |

![Interfaz de configuración de Generic OpenAI de AnythingLLM](https://cdn.acedata.cloud/a155f5476de7.png)

> Las capacidades del modelo y el límite de contexto se basan en el catálogo del modelo actual.

Presta atención a las reglas de ruta de la Base URL:

| Base URL | Solicitud real | Resultado |
| - | - | - |
| `https://api.acedata.cloud/v1` | `https://api.acedata.cloud/v1/chat/completions` | Correcto |
| `https://api.acedata.cloud/openai` | `https://api.acedata.cloud/openai/chat/completions` | También funciona |
| `https://api.acedata.cloud/openai/v1` | `https://api.acedata.cloud/openai/v1/chat/completions` | 404 (no hay `/v1` bajo `/openai`) |
| `https://api.acedata.cloud` | `https://api.acedata.cloud/chat/completions` | 404 (falta `/v1`) |

## Configurar el modelo de Embedding

El núcleo de AnythingLLM es RAG, que requiere un modelo de incrustaciones para vectorizar los documentos. Su **Embedding Preference** y LLM Preference son dos conjuntos de configuraciones independientes entre sí; consulta la [visión general de configuración de Embedder](https://docs.anythingllm.com/setup/embedder-configuration/overview). Su **AnythingLLM Embedder (Built-in / Native)** integrado se ejecuta directamente de forma local, funciona de inmediato y no requiere configuración, por lo que es la opción predeterminada y recomendada:

Entra en **Settings → Embedding Preference**, mantén como Provider el **AnythingLLM Embedder** predeterminado; no es necesario completar ninguna clave. Completará localmente la vectorización de documentos, y tanto el texto original como los vectores se almacenarán en la LanceDB local, sin subirlos a la nube.

> Las opciones de Embedder de AnythingLLM (en la nube: OpenAI / Azure OpenAI / Cohere; locales: Built-in, LM Studio, [LocalAI](https://docs.anythingllm.com/setup/embedder-configuration/local/localai), Ollama) se integran según sus respectivas formas fijas. Entre ellas, las incrustaciones de OpenAI en la nube apuntan de forma fija a `api.openai.com` y no admiten una Base URL personalizada; si deseas usar un endpoint personalizado, puedes utilizar el Embedder **Generic OpenAI** (también incluye un campo Base URL, que puede apuntar a `text-embedding-3-large` de Ace Data Cloud) o el Embedder local **LocalAI**. En este artículo, el modelo de conversación usa Ace Data Cloud, mientras que las incrustaciones usan el Embedder local integrado de AnythingLLM; ambos no se afectan mutuamente.

## Seleccionar un modelo

El catálogo de modelos se actualizará continuamente. Prioriza la lista de modelos cargada automáticamente por el cliente; cuando necesites completarlo manualmente, primero solicita `GET https://api.acedata.cloud/v1/models` para obtener el ID del modelo actual, y luego selecciona según las capacidades de contexto, imágenes y llamadas a herramientas compatibles con el cliente.

## Verificar la integración

Si no estás seguro de si el problema está en AnythingLLM o en la red, primero puedes usar curl para verificar directamente el endpoint (reemplaza `{token}` por tu Token):

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/v1/chat/completions' \
  -H 'Authorization: Bearer {token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "ping"}]
  }'
```

Que se devuelva un objeto `chat.completion` compatible con OpenAI indica que tanto el Token como el endpoint están listos; si se devuelve `HTTP 403 used_up`, significa que el Token es válido pero el saldo es insuficiente, y puedes recargar en la [consola](https://platform.acedata.cloud/console/applications).

## Avanzado: Workspace y conversación con documentos

Después de crear un nuevo Workspace, sube documentos PDF / Word / Markdown, etc. AnythingLLM los dividirá por párrafos, generará vectores usando el Embedder local y los almacenará en la LanceDB local. Durante la conversación, primero recuperará fragmentos relevantes y luego entregará los fragmentos junto con tu pregunta al modelo de conversación (es decir, Ace Data Cloud) para responder, indicando las fuentes citadas debajo de la respuesta. En la parte superior de cada Workspace puedes cambiar entre los modos **Query** (responde únicamente basándose en documentos) y **Chat** (combina conocimientos generales); para escenarios serios se recomienda usar el modo Query para evitar alucinaciones. En el despliegue con Docker, se pueden usar variables de entorno como `GENERIC_OPEN_AI_BASE_PATH`, `GENERIC_OPEN_AI_API_KEY`, `GENERIC_OPEN_AI_MODEL_PREF` para preconfigurar la misma integración del modelo de conversación y activar el modo multiusuario.

## Preguntas frecuentes

### Aparece 404 / connection fail

Normalmente se debe a que la Base URL se escribió como `.../openai/v1` o falta `/v1`. Cámbiala a `https://api.acedata.cloud/v1`.

### No se puede conversar después de subir documentos

Confirma que se haya seleccionado un Embedder disponible en **Settings → Embedding Preference** (el AnythingLLM Embedder predeterminado puede ejecutarse localmente sin configuración adicional) y vuelve a subir los documentos para generar los vectores.

### Aparece 401 Unauthorized

Confirma que lo que está pegado en la API Key es el Token de Ace Data Cloud (sin el prefijo `Bearer`, sin espacios adicionales), y que el saldo de la aplicación correspondiente sea suficiente.

### ¿Los documentos locales se cargarán a la nube?

No. El texto original de los documentos se almacena en LanceDB local, y solo los fragmentos que coinciden en la búsqueda junto con tu pregunta se enviarán al modelo.

## Más información

* [Sitio web oficial de AnythingLLM](https://anythingllm.com/) ｜ [AnythingLLM GitHub](https://github.com/Mintplex-Labs/anything-llm) ｜ [Documentación de despliegue con Docker](https://docs.anythingllm.com/installation-docker/overview)
* [Documentación del proveedor LLM AnythingLLM OpenAI (Generic)](https://docs.anythingllm.com/setup/llm-configuration/cloud/openai-generic)
* [Resumen de configuración de Embedder de AnythingLLM](https://docs.anythingllm.com/setup/embedder-configuration/overview)
* [Documentación de la API OpenAI Chat Completions de Ace Data Cloud](https://platform.acedata.cloud/documents/openai-chat-completions)
* [Lista de servicios de Ace Data Cloud](https://platform.acedata.cloud/documents)
* [Consola de Ace Data Cloud](https://platform.acedata.cloud/console)


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