---
title: "Présentation de l'API REST"
description: "Utilisez AI Glot via HTTP pour inspecter un espace de travail, les crédits et les traductions."
canonical: "https://ai-glot.com/docs/fr/api/overview"
updated: "2026-08-12"
---

# Présentation de l'API REST

L'API REST d'AI Glot est la source de vérité utilisée par la CLI et les intégrations MCP.

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

## Ce que v1 permet de faire

- Lire les capacités de l'espace de travail, les limites du forfait et les scopes accordés.
- Consulter le solde de crédits, les attributions et l'utilisation au fil du temps.
- Lister et inspecter les traductions existantes.
- Renommer, archiver, restaurer et télécharger les traductions terminées.
- Créer, lire, mettre à jour, remplacer et supprimer des glossaires.
- Consulter le catalogue des langues supportées.

> **Warning: Pas d'upload ni de lancement de traduction dans v1**
>
> L'API ne permet pas de télécharger des fichiers, de créer des lots, de lancer des traductions ou de dépenser des crédits. Utilisez l'application web pour ces étapes. Vérifiez `capabilities.batch_creation` via `GET /v1/account` au lieu de supposer la disponibilité en fonction du numéro de version.

## Première requête

Créez une clé dans les [Outils développeur](https://app.ai-glot.com/developer), puis appelez l'endpoint du compte :

```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()
```

Les réponses réussies contiennent `data` et `request_id`. Les réponses de type liste contiennent également `has_more` et `next_cursor`.

## Contrat lisible par machine

La spécification en direct est disponible sur [api.ai-glot.com/openapi.json](https://api.ai-glot.com/openapi.json). Cette documentation publie le snapshot utilisé pour générer ces pages sur [/docs/openapi.json](/docs/openapi.json).

**Continuer avec l'API**

Authentification et scopes, conventions de requête et structure des erreurs.

[Authentification](/docs/api/authentication)

[Erreurs](/docs/api/errors)