Atus
Início
Documentação

Como usar

Tudo que você precisa para integrar o Atus em minutos. API compatível com OpenAI — troque a URL e pronto.

Autenticação

Todas as requisições exigem o header Authorization: Bearer sk-ant-.... A chave é gerada no painel e vinculada ao seu plano.

Exemplo:

curl https://atus.hostclube.com/v1/chat/completions 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer sk-ant-xxxxxxxxxxxxxxxx" 
  -d '{"model":"gpt4o","messages":[{"role":"user","content":"Olá"}]}'

Endpoints

EndpointMétodoDescrição
/v1/chat/completionsPOSTChat completions (formato OpenAI)
/v1/modelsGETLista modelos disponíveis no seu plano
/v1/messagesPOSTMensagens (formato Anthropic)
/v1/plansGETLista planos públicos
/v1/site-contentGETConteúdo dinâmico do site
/v1/blogGETPosts do blog

Tratamento de erros

A API retorna erros HTTP padrão. Em caso de falha, o retry automático tenta até 3 vezes com backoff exponencial.

CódigoSignificado
200Sucesso
400Requisição inválida (modelo não encontrado, JSON malformado)
401API key inválida ou ausente
429Limite de requisições excedido
500Erro interno — o retry automático entra em ação
502Provider indisponível — fallback para próximo provider

Conversão de formato

O Atus converte automaticamente entre os formatos OpenAI, Anthropic e Gemini. Você pode usar qualquer SDK sem se preocupar com o formato interno.

  • OpenAI → Anthropic: system → system, user → user, assistant → assistant, tool_calls → tool_use
  • Anthropic → OpenAI: system → system, user → user, assistant → assistant, tool_use → tool_calls
  • Gemini: Suporte completo via path /v1beta/...

Documentação

Guia rápido

Em 3 passos você está pronto para usar qualquer modelo de IA via Atus:

  1. Crie sua API key — Acesse o painel, cadastre-se e gere uma chave no formato sk-ant-....
  2. Configure a base URL — Aponte seu SDK para https://atus.hostclube.com/v1.
  3. Escolha o modelo — Use o nome do modelo desejado (ex: gpt4o, claude-3.7-sonnet, deepseek-v4-pro).

Rate limiting

Os limites são baseados no plano contratado:

PlanoRequisições/dia
Free500
Pro10.000
Dev30.000

Ao atingir o limite, a API retorna 429 Too Many Requests. O contador reseta diariamente à meia-noite UTC.

SDKs e clients compatíveis

SDK / ClientConfiguração
OpenAI SDKbase_url = "https://atus.hostclube.com/v1"
Anthropic SDKbase_url = "https://atus.hostclube.com"
LangChainopenai_api_base = "https://atus.hostclube.com/v1"
Cursor / ClineAdicione como provider customizado → atus.hostclube.com/v1
LobeChatConfigure API endpoint → https://atus.hostclube.com/v1
OpenClaudeCustom provider → atus.hostclube.com
ChatboxAPI Host → https://atus.hostclube.com, API Path → /v1

Streaming

O Atus suporta Server-Sent Events (SSE). Basta adicionar "stream": true ao corpo da requisição.

Exemplo com OpenAI SDK Python:

from openai import OpenAI

client = OpenAI(
    base_url="https://atus.hostclube.com/v1",
    api_key="sk-ant-xxxxxxxxxxxxxxxx"
)

stream = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[{"role": "user", "content": "Conte até 10"}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Como usar