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

# Använd Ace Data Cloud i AnythingLLM

> Platform API guide - Ace Data Cloud

[AnythingLLM](https://anythingllm.com/) är en klient med öppen källkod som är inriktad på ”dokument → privat ChatGPT”. Kärnkonceptet är **Workspace** — varje Workspace är en uppsättning dokument, en uppsättning användare och en uppsättning Agent-verktyg, separat isolerade. Den är särskilt utformad för dokumentkonversationer och erbjuder både en skrivbordsapp och Docker-form. I **LLM Provider** har den det inbyggda alternativet [OpenAI (Generic)](https://docs.anythingllm.com/setup/llm-configuration/cloud/openai-generic), där du kan ange en anpassad Base URL, och därför kan konversationsmodellen direkt peka på Ace Data Cloud. Den här artikeln introducerar konfigurationsprocessen.

## Ansökningsprocess

För att ansluta Ace Data Cloud i AnythingLLM går du först till [Ace Data Cloud-konsolen](https://platform.acedata.cloud/console/applications), hämtar din API Token och sparar den för senare användning.

![Hämta Ace Data Cloud API Key](https://cdn.acedata.cloud/dvc3cg.jpg)

Om du ännu inte har loggat in eller registrerat dig omdirigeras du automatiskt till inloggningssidan där du uppmanas att registrera dig och logga in. Efter inloggning och registrering återgår du automatiskt till den aktuella sidan.

Vid den första ansökan får du en kostnadsfri kvot, så att du gratis kan prova Ace Data Clouds modelltjänster.

## Ladda ner AnythingLLM

För personlig användning kan du ladda ner [skrivbordsversionen](https://anythingllm.com/download). Vektordatabasen (LanceDB) körs lokalt, dokumentsökning sker helt offline och internetanslutning används endast när modellen anropas; för team- och fleranvändarscenarier används [Docker-distribution](https://docs.anythingllm.com/installation-docker/overview).

## Konfigurera konversationsmodellen

Starta AnythingLLM, gå till **Settings → LLM Preference**, och välj **OpenAI (Generic)** som Provider (välj inte vanliga OpenAI, eftersom den är fast riktad mot `api.openai.com` och saknar anpassad Base URL). Se den officiella dokumentationen [OpenAI (Generic) LLM Provider](https://docs.anythingllm.com/setup/llm-configuration/cloud/openai-generic).

| Fält | Värde | Beskrivning |
| - | - | - |
| Base URL | `https://api.acedata.cloud/v1` | **Måste sluta med `/v1`** |
| API Key | Din Ace Data Cloud Token | Token som kopierats från konsolen |
| Selected Model | Aktuellt modell-ID | Använd i första hand listan som laddas automatiskt från `/models`; om den inte returneras, fråga enligt metoden ovan och fyll sedan i manuellt |
| Model context window | Fyll i enligt vald modell | Läs kontextgränsen från den aktuella modellkatalogen, kopiera inte värden från andra modeller |

![AnythingLLM Generic OpenAI-konfigurationsgränssnitt](https://cdn.acedata.cloud/a155f5476de7.png)

> Modellfunktioner och kontextgränser baseras på den aktuella modellkatalogen.

Observera sökvägsreglerna för Base URL:

| Base URL | Faktisk begäran | Resultat |
| - | - | - |
| `https://api.acedata.cloud/v1` | `https://api.acedata.cloud/v1/chat/completions` | Korrekt |
| `https://api.acedata.cloud/openai` | `https://api.acedata.cloud/openai/chat/completions` | Kan också användas |
| `https://api.acedata.cloud/openai/v1` | `https://api.acedata.cloud/openai/v1/chat/completions` | 404 (det finns inget `/v1` under `/openai`) |
| `https://api.acedata.cloud` | `https://api.acedata.cloud/chat/completions` | 404 (saknar `/v1`) |

## Konfigurera Embedding-modellen

Kärnan i AnythingLLM är RAG, vilket kräver en inbäddningsmodell för att vektorisera dokument. Dess **Embedding Preference** och LLM Preference är två oberoende konfigurationer — se [översikt över Embedder-konfiguration](https://docs.anythingllm.com/setup/embedder-configuration/overview). Den inbyggda **AnythingLLM Embedder（Built-in / Native）** körs direkt lokalt, fungerar direkt utan konfiguration och är det standardval och rekommenderade alternativet:

Gå till **Settings → Embedding Preference**, och behåll standardprovidern **AnythingLLM Embedder**. Du behöver inte fylla i några nycklar. Den slutför dokumentvektorisering lokalt; både originaltexten och vektorerna lagras i lokala LanceDB och laddas inte upp till molnet.

> AnythingLLM:s Embedder-alternativ (moln: OpenAI / Azure OpenAI / Cohere; lokalt: Built-in, LM Studio, [LocalAI](https://docs.anythingllm.com/setup/embedder-configuration/local/localai), Ollama) ansluts alla enligt sina respektive fasta format. OpenAI-inbäddning i molnet är fast riktad mot `api.openai.com` och stöder inte en anpassad Base URL; om du vill använda en anpassad slutpunkt kan du använda **Generic OpenAI** Embedder (som också har ett Base URL-fält och kan peka på Ace Data Clouds `text-embedding-3-large`) eller lokala **LocalAI** Embedder. I den här artikeln använder konversationsmodellen Ace Data Cloud, medan inbäddning använder AnythingLLM:s inbyggda lokala Embedder; de två påverkar inte varandra.

## Välj modell

Modellkatalogen uppdateras kontinuerligt. Använd i första hand modellistan som laddas automatiskt av klienten; när du behöver fylla i manuellt, begär först `GET https://api.acedata.cloud/v1/models` för att hämta aktuella modell-ID:n och välj sedan enligt de kontext-, bild- och verktygsanropsfunktioner som klienten stöder.

## Verifiera anslutningen

Om du är osäker på om problemet ligger i AnythingLLM eller nätverket kan du först använda curl för att direkt verifiera slutpunkten (ersätt `{token}` med din 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"}]
  }'
```

Om ett OpenAI-kompatibelt `chat.completion`-objekt returneras betyder det att både Token och slutpunkten är redo; om `HTTP 403 used_up` returneras betyder det att Token är giltig men att saldot är otillräckligt. Gå då till [konsolen](https://platform.acedata.cloud/console/applications) för att fylla på.

## Avancerat: Workspace och dokumentkonversationer

Efter att du har skapat ett nytt Workspace och laddat upp PDF-, Word-, Markdown- och andra dokument kommer AnythingLLM att dela upp dem efter stycken, använda den lokala Embedder för att generera vektorer och lagra dem i lokala LanceDB. Vid konversation söker den först efter relevanta segment och skickar sedan segmenten tillsammans med din fråga till konversationsmodellen (det vill säga Ace Data Cloud) för svar, och markerar citerade källor under svaret. Överst i varje Workspace kan du växla mellan lägena **Query** (svarar endast baserat på dokument) och **Chat** (blandar allmän kunskap). I seriösa scenarier rekommenderas Query-läget för att undvika hallucinationer. Vid Docker-distribution kan miljövariabler som `GENERIC_OPEN_AI_BASE_PATH`, `GENERIC_OPEN_AI_API_KEY` och `GENERIC_OPEN_AI_MODEL_PREF` användas för att förinställa samma anslutning för konversationsmodellen och aktivera fleranvändarläge.

## Vanliga frågor

### Meddelandet 404 / connection fail

Vanligtvis beror det på att Base URL har skrivits som `.../openai/v1` eller att `/v1` saknas. Ändra till `https://api.acedata.cloud/v1`.

### Det går inte att konversera efter att dokument har laddats upp

Kontrollera att en tillgänglig Embedder har valts i **Settings → Embedding Preference** (standardvalet AnythingLLM Embedder kan köras lokalt och kräver ingen ytterligare konfiguration), och ladda upp dokumenten igen för att generera vektorer.

### Meddelandet 401 Unauthorized

Bekräfta att det som klistras in i API Key är Ace Data Clouds Token (utan prefixet `Bearer`, utan extra mellanslag), och att saldot för den tillhörande applikationen är tillräckligt.

### Kommer lokala dokument att laddas upp till molnet

Nej. Dokumentens originaltext lagras i lokala LanceDB, och endast de fragment som träffas vid sökningen samt din fråga skickas till modellen.

## Läs mer

* [AnythingLLM:s officiella webbplats](https://anythingllm.com/) ｜ [AnythingLLM GitHub](https://github.com/Mintplex-Labs/anything-llm) ｜ [Docker-distributionsdokumentation](https://docs.anythingllm.com/installation-docker/overview)
* [AnythingLLM OpenAI (Generic) LLM Provider-dokumentation](https://docs.anythingllm.com/setup/llm-configuration/cloud/openai-generic)
* [Översikt över AnythingLLM Embedder-konfiguration](https://docs.anythingllm.com/setup/embedder-configuration/overview)
* [Ace Data Cloud OpenAI Chat Completions API-dokumentation](https://platform.acedata.cloud/documents/openai-chat-completions)
* [Ace Data Cloud tjänstelista](https://platform.acedata.cloud/documents)
* [Ace Data Cloud-konsol](https://platform.acedata.cloud/console)


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