API do plano de dados

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.

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.

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 [email protected] ou use https://atlasberg.com/pt-br/contato. A resposta vem em até um dia útil.