---
title: "Overzicht van de REST API"
description: "Gebruik AI Glot via HTTP om een werkruimte, credits en vertalingen te bekijken, resultaten te downloaden en woordenlijsten te automatiseren via een stabiel JSON-contract."
canonical: "https://ai-glot.com/docs/nl/api/overview"
updated: "2026-10-12"
---

# Overzicht van de REST API

De AI Glot REST API is de bron waarop de CLI- en MCP-integraties zijn gebaseerd.

```text
https://api.ai-glot.com/v1
```

## Wat v1 kan

- Werkruimtemogelijkheden, abonnementslimieten en toegekende scopes bekijken.
- Creditsaldo, toekenningen en verbruik in de loop van de tijd bekijken.
- Een bestand uploaden en een [vertaling maken](/docs/api/translations/create), als JSON-tekst, HTTPS-URL of multipart-formuliergegevens.
- In gewone taal [plannen](/docs/api/translations/plan) wat er moet worden vertaald en dit verder verfijnen, en het berekende resultaat bekijken.
- Een plan [goedkeuren](/docs/api/translations/approve) om het werk te starten, of een lopende vertaling [annuleren](/docs/api/translations/cancel).
- Vertalingen weergeven en bekijken.
- Voltooide vertalingen hernoemen, archiveren, herstellen en downloaden.
- Woordenlijsten maken, bekijken, bijwerken, vervangen en verwijderen.
- De catalogus met ondersteunde talen bekijken.
- Open feedback indienen over het gebruik van de API, CLI of MCP-server.

> **Warning: Alleen goedkeuren kost credits**
>
> Een vertaling maken en plannen kost niets en kan onbeperkt worden herhaald. Met `POST /v1/batches/{id}/approve` wordt het gemeten aantal woorden van het plan gereserveerd en begint het werk. Zorg dus dat deze aanroep pas na bevestiging wordt gedaan. Lees `capabilities.batch_creation` op via `GET /v1/account` om te controleren of de werkruimte vertalingen mag starten. Leid dit niet af uit een versienummer.

## Eerste verzoek

Maak een sleutel aan in [Developer tools](https://app.ai-glot.com/developer) en roep daarna het account-endpoint aan:

```bash title="cURL"
curl https://api.ai-glot.com/v1/account \
  -H "Authorization: Bearer $AIGLOT_API_KEY"
```

```js title="JavaScript"
const response = await fetch('https://api.ai-glot.com/v1/account', {
  headers: { Authorization: `Bearer ${process.env.AIGLOT_API_KEY}` },
});
const payload = await response.json();
```

```python title="Python"
import os, requests

response = requests.get(
    "https://api.ai-glot.com/v1/account",
    headers={"Authorization": f"Bearer {os.environ['AIGLOT_API_KEY']}"},
)
payload = response.json()
```

Geslaagde responses bevatten `data` en `request_id`. Lijstresponses bevatten ook `has_more` en `next_cursor`.

## Machineleesbaar contract

De actuele specificatie staat op [api.ai-glot.com/openapi.json](https://api.ai-glot.com/openapi.json). Deze documentatie publiceert de momentopname die wordt gebruikt om deze pagina's weer te geven op [/docs/openapi.json](/docs/openapi.json).

**Verder met de API**

Authenticatie en scopes, conventies voor verzoeken en de opbouw van foutmeldingen.

[Authenticatie](/docs/api/authentication)

[Fouten](/docs/api/errors)