# grunden.ai — fullständig information

> Svensk EU-AI: GLM 5.1 (754B MoE, 200K context, MIT-licens) för chat plus
> en specialiserad modell-flotta (tal-till-text, text-till-tal, embeddings,
> rerank, PII-detektering) på egen NVIDIA H200-hårdvara i Stockholm.
> OpenAI-kompatibelt API — byt endpoint, behåll din kod. Gratis chat,
> prenumeration eller förbetald wallet. Svensk bokföring och kontantfaktura
> vid varje betalning.

## Om tjänsten

grunden.ai servar GLM 5.1 (open-weight flaggskeppsmodell från Z.ai) plus
en specialiserad modell-flotta via ett OpenAI-kompatibelt API och ett
webbgränssnitt. All inferens körs på egen NVIDIA H200-hårdvara i Stockholm
— inga externa modell-leverantörer. Utfärdare: Grunden AI AB
(org.nr 559341-9129, VAT SE559341912901).

### Positionering

- **Svensk databehandling**: All inferens och lagring inom EU (Stockholm).
  Inga tredjelandsöverföringar. BFL-konform bokföring.
- **OpenAI-kompatibelt**: Byt `base_url` till `https://api.grunden.ai`,
  behåll din befintliga kod. Samma `/v1/chat/completions`-endpoint,
  samma JSON-format, samma streaming via SSE.
- **Transparens**: Priser per token publicerade öppet. Ingen dold debitering.
  Automatisk kontantfaktura vid varje betalning.

## Produkter

### Chat-gränssnitt

URL: https://grunden.ai/chat

Webbaserad chat med GLM 5.1. 7 dagars gratis vid nyregistrering, därefter
3 promptar/dag utan abonnemang. Chatt-abonnemang: 99 kr/mån (990 kr/år)
ger obegränsad chat med daglig token-cap som anti-missbruk.

### Publikt API

URL: https://grunden.ai/docs

OpenAI-kompatibelt API med Bearer-autentisering. API-nycklar börjar på
`sk-grunden-` och skapas via dashboard.

## Dokumentationsstruktur (för LLM-agenter)

Hela docs-trädet med kort hint per sida — använd dessa URL:er för att
hämta detaljer:

- https://grunden.ai/docs — Kom igång (registrering, första anrop, redigerings-integration)
- https://grunden.ai/docs/kapaciteter — Översikt över alla sex modeller (paraply)
- https://grunden.ai/docs/kapaciteter/chat — Chat (GLM 5.1) detalj-syntax
- https://grunden.ai/docs/kapaciteter/tal-till-text — Tal-till-text (KB-Whisper-Large), batch + WebSocket
- https://grunden.ai/docs/kapaciteter/text-till-tal — Text-till-tal (Chatterbox), AI Act 50.2-headers
- https://grunden.ai/docs/kapaciteter/embeddings — Embeddings (BGE-M3, 1024-dim)
- https://grunden.ai/docs/kapaciteter/rerank — Rerank (BGE-reranker-v2-m3, cross-encoder)
- https://grunden.ai/docs/kapaciteter/pii — PII-detektering (GLiNER, multi-språk)
- https://grunden.ai/docs/guider — Avancerade mönster (streaming, tools, async, RAG, idempotency)
- https://grunden.ai/docs/modeller — Full pris-tabell + tiers (normal/priority/async)
- https://grunden.ai/docs/api — API-referens (bas-URL, endpoints-tabell, felkoder, auth)
- https://grunden.ai/docs/konto — Konto & fakturering (nycklar, wallet, abonnemang, kvitton)
- https://grunden.ai/docs/compliance — Compliance & EU (GDPR, AI Act, jurisdiktion, DPIA, DPA)

## API-referens

### Bas-URL:er

- **Produktion**: `https://api.grunden.ai`
- **Staging**: `https://staging.grunden.ai` (icke-stabil, inga SLA)

### Endpoints

#### POST /v1/chat/completions

Chat completions — den primära endpointen.

**Request-format** (OpenAI-kompatibelt):
```json
{
  "model": "glm-5.1",
  "messages": [
    {"role": "system", "content": "Du är en hjälpsam assistent."},
    {"role": "user", "content": "Hej!"}
  ],
  "stream": false,
  "max_tokens": 4096,
  "temperature": 0.7
}
```

**Streaming**: `"stream": true` → SSE-chunks i OpenAI delta-format.

**Tool-calling**: `tools` + `tool_choice` på request, `tool_calls` i
assistant-svaret, `role:"tool"` med `tool_call_id` för resultatet.

**Tiers** (via `tier`-parameter):
- `"normal"` (default) — standardhastighet
- `"priority"` (2× pris) — snabbare svar
- `"async"` (½× pris) — webhook inom 12 h, kräver `webhook_url`

**Async-flöde**:
1. Skicka `tier:"async" + webhook_url` → 202 med `job_id`
2. Resultat levereras via POST till `webhook_url` inom 12 timmar
3. Webhook signeras med HMAC-SHA256 i `X-Grunden-Signature`-header

**Webhook-signatur (v2, rekommenderad)**: vi skickar två headers:
- `X-Grunden-Signature: sha256=<hex>` — HMAC-SHA256 över raw body (v1, kompatibilitetshärd)
- `X-Grunden-Signature-V2: t=<unix_ts>,v1=<hex>` — Stripe-mönster:
  HMAC-SHA256 över `v1:<unix_ts>:<raw_body>` med din webhook-nyckel.
  Tidsstämpeln `t` skyddar mot replay-attacker; avvisa requests där
  `abs(now - t) > 5 min`. Verifiera signaturen INNAN du läser bodyn.

V2 är preferred för nya integrations; v1 fortsätter levereras parallellt
för existerande klienter.

**Idempotency**: `Idempotency-Key` header (UUID/ULID, max 128 tecken)
för säkra retries — samma nyckel inom 24h returnerar cache:ad response
utan ny debitering.

#### POST /v1/audio/transcriptions

Tal-till-text (KB-Whisper-Large, svensk-optimerad). Multipart-upload:

```bash
curl https://api.grunden.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $GRUNDEN_API_KEY" \
  -F file=@samtal.wav \
  -F model=kb-whisper-large
```

Returnerar JSON med `text` + `segments` (start/end + ord-tidsstämplar).
Diarisering är opt-in (kräver attestation per AI Act art. 9).

#### WSS /v1/audio/realtime

Realtime tal-till-text via WebSocket. Init-meddelande (JSON med model + sample_rate) +
binär stream av PCM-frames. Servern returnerar partial + final transcripts som
JSON-meddelanden.

#### POST /v1/audio/speech

Text-till-tal (Chatterbox). JSON in, WAV ut:

```json
{ "model": "chatterbox", "input": "Hej!", "voice": "alloy" }
```

Response är audio/wav med `X-AI-Generated: true`-header (AI Act art. 50.2).

#### POST /v1/embeddings

Embeddings (BGE-M3, 1024-dim, multilingual). OpenAI-kompatibel:

```json
{ "model": "bge-m3", "input": ["text 1", "text 2"] }
```

#### POST /v1/rerank

Cross-encoder rerank (BGE-reranker-v2-m3). Skicka query + lista texter:

```json
{ "model": "bge-reranker-v2-m3", "query": "vad är RAG?",
  "documents": ["text A", "text B", "text C"] }
```

Returnerar relevans-scores per dokument.

#### POST /v1/pii/redact

PII-detektering och -maskering (GLiNER, multi-språk):

```json
{ "text": "Anna Andersson, 19850101-1234, anna@example.com" }
```

Returnerar maskerad version + detection-spans.

#### GET /v1/models

Listar aktiva modeller. Kräver `Authorization: Bearer sk-grunden-…`.

#### GET /v1/batch/{id}

Status för async batch-jobb. Kräver autentisering.

#### DELETE /v1/account

Raderar API-användarens konto (GDPR art. 17). Kräver autentisering.

#### GET /v1/audit-log

Hämtar användarens audit-log (GDPR art. 15). Kräver autentisering.

### Autentisering

`Authorization: Bearer sk-grunden-…` i request-header.

API-nycklar hanteras via dashboard eller API. Nycklar hashas med SHA-256
vid lagring. Constant-time-jämförelse vid autentisering.

### Rate-limit-signaler

`Retry-After` + `X-RateLimit-Remaining-Requests` +
`X-RateLimit-Remaining-Tokens` headers på 429-svar.

## Aktuella modeller

_Live-lista via GET /v1/models._

## Prismodell

### Gratis-läge (chat)

Nya konton får 7 dagars obegränsad chat. Därefter 3 promptar/dag utan
abonnemang. Rate limit per session.

### Chatt-abonnemang

99 kr/mån inkl. moms (eller 990 kr/år). Obegränsad chat med GLM 5.1,
med en daglig token-cap som anti-missbruk.

### Förbetald wallet (API)

Fyll på saldo via kort (Mollie) och debiteras per token.

Chat-pris (SEK per 1M tokens, input/output):
- Normal: 60/180
- Priority (2×): 120/360
- Async (½×, webhook inom 12 h): 30/90

Specialmodeller (beta-priser, debitering aktiveras efter 30 dagars varsel):
- Tal-till-text: per minut audio
- Text-till-tal: per 1M tecken in
- Embeddings: per 1M tokens in
- Rerank: per 1 000 queries
- PII-detektering: per 1M tecken in

Aktuella priser: https://grunden.ai/docs/modeller

Kontantfaktura ställs ut automatiskt vid varje betalning enligt
Bokföringslagen. Standardvaluta: SEK.

### RAG (Retrieval-Augmented Generation)

Ladda upp dokument (PDF/DOCX/CSV/HTML/XLSX/PPTX) i chatten. Modellen
söker automatiskt i dina dokument när relevanta frågor ställs.
Dokument lagras krypterat på svensk infrastruktur.

## Juridik och compliance

- [Användarvillkor](https://grunden.ai/terms)
- [Integritetspolicy](https://grunden.ai/privacy)
- [Data Processing Agreement (DPA)](https://grunden.ai/dpa) — för B2B-personuppgifts-
  behandling.
- [AI-förordningen (EU AI Act)](https://grunden.ai/ai-act) — vår roll som distributör
  av GLM 5.1 (GPAI) och kundens ansvar.

### GDPR

- Art. 17 (radering): implementerad via `DELETE /v1/account` och
  webbgränssnittets profil-sida. Atomisk DB-radering + storage-cleanup.
- Art. 15 (insyn): `GET /v1/audit-log` + data-export via profil-sidan.
- Art. 28 (DPA): tillgänglig på /dpa.
- Art. 30 (registerförteckning): upprätthållen internt.
- BFL-konflikt med GDPR art. 17 löses via pseudonymisering — belopp,
  datum och org-nummer bevaras 7 år per BFL; personuppgifter raderas.

### EU AI Act

- Klassning: begränsad risk (art. 50.1) — generativt text-system.
- Art. 50.2 (syntetiskt ljud) gäller TTS-endpoint: `/v1/audio/speech`
  returnerar `X-AI-Generated: true`-header på alla WAV-svar.
- User-disclosure implementerad i chat-UI.

### Sub-processors

Alla inom EU/EES: GleSYS AB (VPS+DNS, SE), 6G AI Sweden AB (H200 GPU,
SE), Mollie B.V. (betalningar, NL), Proton AG (SMTP, CH).
Lista: https://grunden.ai/sub-processors

## Kontakt

- hej@grunden.ai — allmänna frågor och support
- privacy@grunden.ai — GDPR / personuppgifter
- security@grunden.ai — säkerhetsincidenter

## Maskinläsbara resurser

- [OpenAPI 3.1 spec](https://grunden.ai/openapi.json)
- [llms.txt](https://grunden.ai/llms.txt) — kort sammanfattning
- [AI-plugin manifest](https://grunden.ai/.well-known/ai-plugin.json)
- [Sitemap](https://grunden.ai/sitemap.xml)