Conecte seus clientes à Quanta

Referência da API

Todos os caminhos abaixo estão em https://api.quantarelay.com; os três protocolos compartilham uma única chave e um único saldo.

Mapa de endpoints

Cabeçalhos e autenticação

• Envie a chave como Authorization: Bearer nas rotas da OpenAI, x-api-key nas rotas da Anthropic e x-goog-api-key nas rotas do Gemini.
• Quando uma requisição à Anthropic não inclui anthropic-version, a Quanta adiciona 2023-06-01.
• A chave também pode ser enviada como parâmetro de consulta ?key=, principalmente em clientes Gemini.
• Seu IP de cliente, cookies e cabeçalhos de CDN nunca são repassados ao provedor.

Limites e tempos de espera

• Por chave: até 120 requisições em qualquer intervalo de 60 segundos
• Por conta: até 8 requisições em andamento
• Corpo da requisição: no máximo 25 MB
• Por conta: até 20 chaves ativas
• Streams: sem limite de tempo total; encerrados apenas após 300 s sem dados do provedor

Formato de erro e códigos de status

Os erros sempre são retornados no formato da OpenAI:

{"error": {"message": "Your Quanta balance is used up. Top up from the dashboard to resume metered calls.", "type": "insufficient_quota", "code": 402}}

Guias de integração

Com o protocolo explicado acima, veja a configuração para cada tipo de cliente.

SDKs da OpenAI, Codex e outros clientes compatíveis

Defina base_url como o endereço base seguido de /v1 e api_key como sua chave. O chat usa /v1/chat/completions; a API Responses fica em /v1/responses.

base_url = "https://api.quantarelay.com/v1"   # Quanta, OpenAI-compatible
api_key  = "qnt-your-key-here"

Python, usando o pacote oficial openai:

from openai import OpenAI  # pip install openai
qt = OpenAI(base_url="https://api.quantarelay.com/v1", api_key="qnt-your-key-here")
qt_reply = qt.chat.completions.create(model="gpt-6.1-sol", messages=[{"role": "user", "content": "Resuma o registro de incidentes deste trimestre em três tópicos"}])
print(qt_reply.choices[0].message.content)

curl https://api.quantarelay.com/v1/chat/completions \
  -H "Authorization: Bearer qnt-your-key-here" -H "Content-Type: application/json" \
  -d '{"model":"gpt-6.1-sol","messages":[{"role":"user","content":"Resuma o registro de incidentes deste trimestre em três tópicos"}]}'

IDs do GPT que sugerimos para começar:

• gpt-6.1-sol
• gpt-6-astra
• gpt-5.6-sol

CLI do Gemini e API nativa do Gemini

Defina GOOGLE_GEMINI_BASE_URL apenas com o host (sem adicionar /v1beta) e GEMINI_API_KEY com sua chave, depois execute gemini.

export GOOGLE_GEMINI_BASE_URL=https://api.quantarelay.com
export GEMINI_API_KEY=qnt-your-key-here
gemini

curl "https://api.quantarelay.com/v1beta/models/gemini-3.8-flash:generateContent" \
  -H "x-goog-api-key: qnt-your-key-here" -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"Liste três formas de reduzir o gasto com tokens em tarefas em lote"}]}]}'

Os modelos Gemini usam apenas o protocolo nativo: :generateContent para uma resposta única, :streamGenerateContent?alt=sse para streaming. Eles não podem ser chamados por /v1/chat/completions.

IDs dos modelos Gemini disponíveis:

• gemini-3.1-pro
• gemini-4-argon
• gemini-3.8-flash
• gemini-2.5-flash

Claude Code e Claude Desktop

Defina duas variáveis de ambiente e execute claude: ANTHROPIC_BASE_URL aponta para o endereço base (sem /v1) e ANTHROPIC_AUTH_TOKEN contém sua chave.

export ANTHROPIC_BASE_URL=https://api.quantarelay.com
export ANTHROPIC_AUTH_TOKEN=qnt-your-key-here
claude

Os modelos Claude estão disponíveis apenas nos clientes oficiais Claude Code e Claude Desktop, e o Claude Code deve estar na versão 2.1.285 ou posterior — uma restrição do provedor de origem. GPT, Gemini e os demais funcionam com qualquer cliente ou SDK compatível.

Cadastrar