— Docs · Quickstart

Comece com a Onerall

A Onerall entrega uma API unificada com acesso a centenas de endpoints por um único ponto de entrada, cuidando de autenticação, limites, fallback e faturamento.

Três formas de integrar

Abordagem	Melhor para
API REST	Controle total, qualquer linguagem, zero dependência
SDK cliente	Chamadas tipadas com o mínimo de boilerplate
Gateway Platform	Revenda com chave por cliente, limite e auditoria

Usando a API Onerall

Envie requisições HTTP padrão para /api/public/v1/{endpoint}. A chave vai no cabeçalho Authorization.

curl https://onerall.com/api/public/v1/text.generate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ONERALL_API_KEY" \
  -d '{
    "input": "Qual é o sentido da vida?"
  }'

const res = await fetch("https://onerall.com/api/public/v1/text.generate", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ONERALL_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ input: "Qual é o sentido da vida?" }),
});

const data = await res.json();
console.log(data.request_id, data.billed_usd);

import os, requests

res = requests.post(
    "https://onerall.com/api/public/v1/text.generate",
    headers={"Authorization": f"Bearer {os.environ['ONERALL_API_KEY']}"},
    json={"input": "Qual é o sentido da vida?"},
)
print(res.json())

Resposta

{
  "endpoint": "text.generate",
  "status": "accepted",
  "request_id": "0f0f1c2e-...",
  "billed_usd": 0.0042,
  "received_at": "2026-08-02T18:00:00.000Z"
}

Todo request entra na trilha de auditoria com status, latência, IP, custo de atacado e receita de revenda — visível em /console e em /admin.

Próximos passos

Crie sua chave em /console, escolha um plano em /apis e configure limites por endpoint no painel administrativo.