— Docs · Referência

Referência da API

Um contrato único para todos os endpoints: mesmo envelope de resposta, mesmos cabeçalhos de limite e o mesmo objeto de uso.

Request

Campo	Tipo	Descrição
input	string \| object	Entrada principal do endpoint
stream	boolean	Ativa Server-Sent Events
routing	object	Ordem de provedores e política de otimização
metadata	object	Chave-valor livre, devolvido na auditoria
idempotency_key	string	Deduplica reenvios por 24h

Response

{
  "id": "req_01HZY6M9K3",
  "endpoint": "text.generate",
  "data": { "output": "..." },
  "usage": { "calls": 1, "unit": "call", "cost_usd": 0.0004 },
  "provider": "provider_a",
  "latency_ms": 412
}

Cabeçalhos de resposta

Cabeçalho	Exemplo
X-Onerall-Request-Id	req_01HZY6M9K3
X-Onerall-Limit	600
X-Onerall-Remaining	583
X-Onerall-Reset	2026-08-02T19:31:00Z
X-Onerall-Quota-Used	184213
X-Onerall-Cost-Usd	0.0004

Idempotência

Envie idempotency_key em qualquer POST. Reenvios com a mesma chave nas próximas 24h retornam a resposta original, sem nova cobrança.