Uma chave, um endereço e as ferramentas que você já usa

1. 1Plano ativo

   Com o pagamento aprovado, o acesso é liberado e o painel fica disponível. A chave de API já faz parte do seu acesso: não existe contratação separada para usar a API.

2. 2Chave gerada e guardada

   No painel, em Conexões, gere a sua chave (começa com 8tk_). Ela é mostrada uma única vez: copie e guarde num lugar seguro.

   • A chave é individual e intransferível. A de outra pessoa não funciona e não deve ser usada.
   • Suspeita de vazamento? Revogue no painel, gere outra e avise o suporte.
3. 3IP autorizado

   No painel, autorize o IP. A autorização usa o IP de onde você está conectado no momento, então faça isso no computador e na rede em que vai usar a chave.

   • Cada licença funciona em um computador por vez.
   • Mudou de lugar ou de rede (casa, escritório)? Entre no painel já conectado na nova rede e autorize de novo.
   • Quer digitar um IP customizável ou liberar um IP adicional? Fale com o suporte no WhatsApp.
   • Usar proxy ou túnel para dividir a chave bloqueia a chave temporariamente.

$env:ANTHROPIC_BASE_URL = "https://8token.tech"
$env:ANTHROPIC_AUTH_TOKEN = "8tk_SUA_CHAVE"
claude

set ANTHROPIC_BASE_URL=https://8token.tech
set ANTHROPIC_AUTH_TOKEN=8tk_SUA_CHAVE
claude

export ANTHROPIC_BASE_URL=https://8token.tech
export ANTHROPIC_AUTH_TOKEN=8tk_SUA_CHAVE
claude

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://8token.tech", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "8tk_SUA_CHAVE", "User")
# Feche este terminal, abra outro e rode:
claude

setx ANTHROPIC_BASE_URL "https://8token.tech"
setx ANTHROPIC_AUTH_TOKEN "8tk_SUA_CHAVE"
rem Feche este terminal, abra outro e rode:
claude

# zsh (padrão no macOS). No bash, troque ~/.zshrc por ~/.bashrc
echo 'export ANTHROPIC_BASE_URL=https://8token.tech' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN=8tk_SUA_CHAVE' >> ~/.zshrc
source ~/.zshrc
claude

$env:EIGHTTOKEN_API_KEY = "8tk_SUA_CHAVE"
codex

set EIGHTTOKEN_API_KEY=8tk_SUA_CHAVE
codex

export EIGHTTOKEN_API_KEY=8tk_SUA_CHAVE
codex

[Environment]::SetEnvironmentVariable("EIGHTTOKEN_API_KEY", "8tk_SUA_CHAVE", "User")
# Feche este terminal, abra outro e rode:
codex

setx EIGHTTOKEN_API_KEY "8tk_SUA_CHAVE"
rem Feche este terminal, abra outro e rode:
codex

# zsh (padrão no macOS). No bash, troque ~/.zshrc por ~/.bashrc
echo 'export EIGHTTOKEN_API_KEY=8tk_SUA_CHAVE' >> ~/.zshrc
source ~/.zshrc
codex

Prefere assistir?

Dois tutoriais do zero até a primeira resposta. O do terminal mostra a instalação, o PATH e as variáveis de ambiente. O do aplicativo mostra o modo desenvolvedor e o formulário do gateway.

Guias por ferramenta

$env:ANTHROPIC_BASE_URL = "https://8token.tech"
$env:ANTHROPIC_AUTH_TOKEN = "8tk_SUA_CHAVE"
claude --model claude-fable-5.1

set ANTHROPIC_BASE_URL=https://8token.tech
set ANTHROPIC_AUTH_TOKEN=8tk_SUA_CHAVE
claude --model claude-fable-5.1

export ANTHROPIC_BASE_URL=https://8token.tech
export ANTHROPIC_AUTH_TOKEN=8tk_SUA_CHAVE
claude --model claude-fable-5.1

Claude DesktopPelo formulário do app, sem editar arquivo

1. Abra o menu do aplicativo

   Clique no ícone ≡ (três linhas) no canto superior esquerdo do Claude Desktop.

2. Vá em Desenvolvedor

   No menu, passe o mouse sobre Desenvolvedor e clique em Configurar Inferência de Terceiros…

3. Crie uma nova configuração

   No canto superior direito, clique em Default ▾ e escolha Duplicar… (ou Nova configuração). Dê um nome como 8Token.

4. Escolha Gateway na Conexão

   Na seção Conexão, troque o destino de Claude API para Gateway.

5. URL base do gateway

   Cole https://8token.tech.

6. Chave de API do gateway

   Cole a sua chave 8tk_….

7. Aplique

   Clique em Aplicar alterações. Pronto: o app passa a responder pela 8Token.

model = "claude-sonnet-5.5"
model_provider = "8token"

[model_providers.8token]
name = "8Token"
base_url = "https://8token.tech/v1"
env_key = "EIGHTTOKEN_API_KEY"
wire_api = "responses"

$env:EIGHTTOKEN_API_KEY = "8tk_SUA_CHAVE"
codex

set EIGHTTOKEN_API_KEY=8tk_SUA_CHAVE
codex

export EIGHTTOKEN_API_KEY=8tk_SUA_CHAVE
codex

node codex-setup.mjs

from openai import OpenAI

client = OpenAI(base_url="https://8token.tech/v1", api_key="8tk_SUA_CHAVE")

r = client.chat.completions.create(
    model="claude-fable-5.1",
    messages=[{"role": "user", "content": "Explique RAG"}],
)
print(r.choices[0].message.content)

import anthropic

# Sem /v1: o SDK acrescenta /v1/messages sozinho
client = anthropic.Anthropic(base_url="https://8token.tech", api_key="8tk_SUA_CHAVE")

msg = client.messages.create(
    model="claude-sonnet-5.5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Explique RAG"}],
)
print(msg.content[0].text)

from google import genai
from google.genai import types

client = genai.Client(
    api_key="8tk_SUA_CHAVE",
    http_options=types.HttpOptions(base_url="https://8token.tech"),
)

r = client.models.generate_content(model="claude-sonnet-5.5", contents="Explique RAG")
print(r.text)

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://8token.tech/v1", apiKey: "8tk_SUA_CHAVE" });

const r = await client.chat.completions.create({
  model: "claude-fable-5.1",
  messages: [{ role: "user", content: "Explique RAG" }],
});
console.log(r.choices[0].message.content);

curl https://8token.tech/v1/messages \
  -H "x-api-key: 8tk_SUA_CHAVE" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5.5","max_tokens":1024,"messages":[{"role":"user","content":"Explique RAG"}]}'

$body = '{"model":"claude-sonnet-5.5","max_tokens":1024,"messages":[{"role":"user","content":"Explique RAG"}]}'
$body | curl.exe https://8token.tech/v1/messages `
  -H "x-api-key: 8tk_SUA_CHAVE" `
  -H "anthropic-version: 2023-06-01" `
  -H "content-type: application/json" `
  --data-binary "@-"

curl https://8token.tech/v1/messages ^
  -H "x-api-key: 8tk_SUA_CHAVE" ^
  -H "anthropic-version: 2023-06-01" ^
  -H "content-type: application/json" ^
  -d "{\"model\":\"claude-sonnet-5.5\",\"max_tokens\":1024,\"messages\":[{\"role\":\"user\",\"content\":\"Explique RAG\"}]}"

curl https://8token.tech/v1/chat/completions \
  -H "Authorization: Bearer 8tk_SUA_CHAVE" \
  -H "content-type: application/json" \
  -d '{"model":"claude-fable-5.1","messages":[{"role":"user","content":"Explique RAG"}]}'

$body = '{"model":"claude-fable-5.1","messages":[{"role":"user","content":"Explique RAG"}]}'
$body | curl.exe https://8token.tech/v1/chat/completions `
  -H "Authorization: Bearer 8tk_SUA_CHAVE" `
  -H "content-type: application/json" `
  --data-binary "@-"

curl https://8token.tech/v1/chat/completions ^
  -H "Authorization: Bearer 8tk_SUA_CHAVE" ^
  -H "content-type: application/json" ^
  -d "{\"model\":\"claude-fable-5.1\",\"messages\":[{\"role\":\"user\",\"content\":\"Explique RAG\"}]}"

curl "https://8token.tech/v1beta/models/claude-sonnet-5.5:generateContent" \
  -H "x-goog-api-key: 8tk_SUA_CHAVE" \
  -H "content-type: application/json" \
  -d '{"contents":[{"parts":[{"text":"Explique RAG"}]}]}'

$body = '{"contents":[{"parts":[{"text":"Explique RAG"}]}]}'
$body | curl.exe "https://8token.tech/v1beta/models/claude-sonnet-5.5:generateContent" `
  -H "x-goog-api-key: 8tk_SUA_CHAVE" `
  -H "content-type: application/json" `
  --data-binary "@-"

curl "https://8token.tech/v1beta/models/claude-sonnet-5.5:generateContent" ^
  -H "x-goog-api-key: 8tk_SUA_CHAVE" ^
  -H "content-type: application/json" ^
  -d "{\"contents\":[{\"parts\":[{\"text\":\"Explique RAG\"}]}]}"

Formatos e endpoints

A mesma chave funciona nos quatro formatos. Cada ferramenta usa o formato que já conhece.

Autenticação

O servidor aceita tanto Authorization: Bearer quanto x-api-key, porque cada SDK manda de um jeito. No formato Gemini, os dois modos do Google também funcionam. Em todos os casos, a chave precisa estar ativa e o IP da máquina precisa estar autorizado no painel.

A regra do /v1

É o erro de configuração mais comum. Guarde assim:

Chamada de ferramentas (tool calling)

Funciona nos quatro formatos, com os campos que cada um já usa:

• Anthropic Messagestool_use e tool_result
• OpenAI Chat Completionstool_calls
• OpenAI Responsesfunction_call e function_call_output
• GeminifunctionCall e functionResponse

Com streaming: o texto comum chega token a token. Só o pedaço que forma uma chamada de ferramenta fica retido até a chamada estar completa, e aí é entregue inteiro.

Testado de ponta a ponta com o Claude Code e o Codex de verdade, num ciclo completo: rodar um teste que falha, ler o arquivo, corrigir, rodar de novo e confirmar que passa.

Limites e desempenho

• Sem cobrança por token e sem janela de 5 horas, dentro da Política de Uso Justo.
• Para manter a estabilidade, existem limites técnicos de requisições por minuto, de requisições simultâneas e de contexto máximo por modelo.
• Horário de pico: a capacidade é ajustada sozinha. Às vezes a requisição espera alguns instantes na fila, mas a geração segue normalmente.
• Prompts muito grandes (cerca de 100 mil tokens) podem ter alguns milissegundos a mais até o primeiro token, porque a requisição passa pelo nosso servidor e pelo do provedor. No uso diário, não se percebe.

Ainda não funcionou?

Mande a mensagem de erro e a ferramenta que você está usando. Nunca envie a sua chave completa.