---
title: "Visão geral da API REST"
description: "Use o AI Glot via HTTP para inspecionar um workspace, créditos e traduções, baixar resultados e automatizar glossários com um contrato JSON estável."
canonical: "https://ai-glot.com/docs/pt/api/overview"
updated: "2026-08-12"
---

# Visão geral da API REST

A API REST do AI Glot é a fonte de verdade por trás das integrações de CLI e MCP.

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

## O que a v1 pode fazer

- Ler capacidades do workspace, limites do plano e escopos concedidos.
- Ler saldo de créditos, concessões e uso ao longo do tempo.
- Listar e inspecionar traduções existentes.
- Renomear, arquivar, restaurar e baixar traduções concluídas.
- Criar, ler, atualizar, substituir e excluir glossários.
- Ler o catálogo de idiomas suportados.

> **Warning: Sem upload ou início de tradução na v1**
>
> A API não pode fazer upload de arquivos, criar lotes (batches), iniciar traduções ou gastar créditos. Use o web app para essas etapas. Verifique `capabilities.batch_creation` em `GET /v1/account` em vez de presumir a disponibilidade com base no número da versão.

## Primeira requisição

Crie uma chave em [Ferramentas de desenvolvedor](https://app.ai-glot.com/developer) e, em seguida, chame o endpoint de conta:

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

Respostas bem-sucedidas contêm `data` e `request_id`. Respostas de listagem também contêm `has_more` e `next_cursor`.

## Contrato legível por máquina

A especificação atualizada está disponível em [api.ai-glot.com/openapi.json](https://api.ai-glot.com/openapi.json). Esta documentação publica o snapshot usado para renderizar estas páginas em [/docs/openapi.json](/docs/openapi.json).

**Continue com a API**

Autenticação e escopos, convenções de requisição e a estrutura de erros.

[Autenticação](/docs/api/authentication)

[Erros](/docs/api/errors)