# API do plano de dados

> API do plano de dados da Atlasberg Platform: endpoints compatíveis com OpenAI sob /v1, rotas drop-in Anthropic e Google GenAI e autenticação com chaves virtuais sk-atlas- ou tokens pessoais atu-.

O plano de inferência. Formato OpenAI sob /v1, compatibilidade drop-in para os principais formatos de cliente e autenticação com chaves virtuais sk-atlas-.

## API do plano de dados

O appliance expõe um único servidor HTTP (porta 8080 no deploy padrão). O plano de dados nunca para, qualquer que seja o estado da licença.

## Autenticação: chaves virtuais

Chaves virtuais carregam o prefixo sk-atlas-. O gateway as lê nestes lugares:

- Header x-atlasberg-vk: valor aceito verbatim.
- Authorization: Bearer <valor>, somente quando o valor tem o prefixo sk-atlas-.
- Headers x-api-key, x-goog-api-key e api-key, somente com o prefixo sk-atlas-, para nunca confundir a API key de um provedor com uma chave virtual.
- Tokens pessoais do login por dispositivo (prefixo atu-) são aceitos nos mesmos lugares: Authorization: Bearer, x-api-key, api-key e x-goog-api-key. O gateway resolve a pessoa e o time dela, injeta a chave virtual viva do time em x-atlasberg-vk e remove o token dos headers antes de a requisição seguir. A chave do time nunca sai do gateway.
- A governança exige a chave quando a obrigatoriedade de auth na inferência está ligada; a mensagem de recusa cita o header.
- BYOK por request: com opt-in do admin, o header x-atlasberg-direct-key: true faz o gateway usar a credencial do próprio Authorization do cliente como chave direta de provedor.

### Tutorial: entre pelo terminal com o SSO da empresa

Como um desenvolvedor obtém um token pessoal atu- com um comando e um código confirmado no portal.

### Tutorial: conecte o Claude Code, o Cursor e os SDKs

As variáveis de base URL e de chave que cada ferramenta lê para mandar as requisições pelo gateway.

```bash
curl -s http://localhost:8080/v1/chat/completions \
  -H "Authorization: Bearer sk-atlas-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<modelo>",
    "messages": [{"role": "user", "content": "Olá"}]
  }'
```

## Rotas nativas (formato OpenAI)

- Método: POST | Rota: /v1/chat/completions | Uso: Chat (formato OpenAI)
- Método: POST | Rota: /v1/completions | Uso: Text completion
- Método: POST | Rota: /v1/responses | Uso: Responses API
- Método: GET/DELETE | Rota: /v1/responses/{response_id} | Uso: Recuperar ou apagar resposta
- Método: POST | Rota: /v1/responses/{response_id}/cancel | Uso: Cancelar
- Método: GET | Rota: /v1/responses/{response_id}/input_items | Uso: Itens de entrada
- Método: POST | Rota: /v1/responses/input_tokens | Uso: Contagem de tokens
- Método: POST | Rota: /v1/responses/compact | Uso: Compaction
- Método: POST | Rota: /v1/embeddings | Uso: Embeddings
- Método: POST | Rota: /v1/rerank | Uso: Rerank
- Método: POST | Rota: /v1/ocr | Uso: OCR
- Método: POST | Rota: /v1/audio/speech | Uso: TTS
- Método: POST | Rota: /v1/audio/transcriptions | Uso: ASR
- Método: POST | Rota: /v1/images/generations, /v1/images/edits, /v1/images/variations | Uso: Imagens
- Método: POST/GET | Rota: /v1/videos, /v1/videos/{video_id}, /v1/videos/{video_id}/content, /v1/videos/{video_id}/remix | Uso: Vídeo
- Método: GET | Rota: /v1/models | Uso: Catálogo de modelos
- Método: POST/GET | Rota: /v1/batches, /v1/batches/{batch_id}, /v1/batches/{batch_id}/results, /v1/batches/{batch_id}/cancel | Uso: Batches
- Método: POST/GET/DELETE | Rota: /v1/files, /v1/files/{file_id}, /v1/files/{file_id}/content | Uso: Arquivos
- Método: POST/GET/DELETE | Rota: /v1/containers, /v1/containers/{container_id}/... | Uso: Containers

## Compatibilidade drop-in

- Anthropic: POST /v1/messages, /v1/messages/count_tokens e /v1/messages/batches. Um cliente Anthropic aponta a base URL para o gateway sem mudar o formato do corpo.
- OpenAI drop-in: prefixo /openai, por exemplo /openai/v1/chat/completions, /openai/chat/completions, /openai/models, /openai/files, /openai/batches, /openai/realtime.
- Google GenAI: prefixo /genai.
- LiteLLM: prefixo /litellm, que agrega os formatos OpenAI, Anthropic, GenAI e Bedrock.
- Passthrough: prefixos /openai_passthrough, /anthropic_passthrough e /genai_passthrough.

```bash
curl -s http://localhost:8080/v1/messages \
  -H "x-atlasberg-vk: sk-atlas-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<modelo>",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Olá"}]
  }'
```

## Saúde e métricas

Flood sem autenticação: Requisição de inferência sem credencial servível é recusada com 401 na porta e agregada num evento auth.refused_burst por origem, em vez de escrever dois eventos na trilha por chamada.

- GET /health: a resposta saudável carrega "status":"ok" mais um bloco de componentes.
- GET /metrics: scrape Prometheus. A lista completa de métricas está na página Protocolo.

## Sobre a Atlasberg Platform

A Atlasberg Platform é a camada de controle entre uma empresa e todos os modelos de IA: cada requisição é autenticada com uma chave virtual, filtrada por política e DLP, roteada para o provedor certo e gravada numa trilha de auditoria encadeada por hash. Expõe uma API compatível com a OpenAI, então as aplicações só trocam a URL base.

O mesmo artefato roda na Atlasberg Cloud, na sua VPC, on-premises ou totalmente air-gapped, e é cobrado por capacidade e módulos, nunca por assento.

Esta página faz parte da documentação oficial. Para falar com o time de engenharia, escreva para contact@atlasberg.com ou use https://atlasberg.com/pt-br/contato. A resposta vem em até um dia útil.

## Mais da Atlasberg

- [Índice da documentação](https://atlasberg.com/pt-br/docs)
- [Visão geral da plataforma](https://atlasberg.com/pt-br)
- [Fale com a engenharia](https://atlasberg.com/pt-br/contato)

---
Fonte: https://atlasberg.com/pt-br/docs/api
Empresa: Sobimann Tecnologia da Informacao LTDA (Atlasberg), Porto Alegre, RS, Brasil.
Contato: contact@atlasberg.com - resposta em até um dia útil.
Índice para agentes: https://atlasberg.com/llms.txt