C
Guia da API do Claude

Claude no TokenHub — Models Anthropic OpenAI-Compatible

Chame os models Claude da Anthropic pelo endpoint unificado /chat/completions do TokenHub. Formato de request e response totalmente OpenAI-compatible — sem necessidade de migração de SDK. Streaming, uso de ferramentas (function calling) e visão (entrada de imagem) são todos suportados. Cobrança por token por tier de model.

OpenAI-CompatibleStreamingTool UseVisionClaude 3 → 4.7Token-based

1Obtenha sua API Key

  1. Visite tokenhub.store e crie uma conta (login com GitHub / Google compatível)
  2. Vá para Dashboard → API Keys, clique em "Create New Key"
  3. Vá para Dashboard → Billing para adicionar Credits (1 Credit = $1 USD)
  4. Copie a API Key (formato: th-xxxxxxxxxxxx...)
⚠️ A API Key é exibida apenas uma vez na criação. Salve-a com segurança; se a perder, crie uma nova.

2Visão geral da API

Base URL

https://tokenhub.store/api/v1

Autenticação

Passe a API Key no cabeçalho Authorization:

Header
Authorization: Bearer th-your-api-key

Endpoint (OpenAI-compatible)

POST
/chat/completions

Conclusão de chat. Mesmo schema do OpenAI /v1/chat/completions, incluindo streaming, uso de ferramentas, visão e modo JSON.

Você pode continuar usando o SDK oficial openai — basta apontar base_url para TokenHub e usar sua API Key do TokenHub. Nenhuma outra alteração no código é necessária.

3Modelos e Preços

A precificação é por 1 milhão de Tokens (USD). Apenas chamadas bem-sucedidas são cobradas. Tanto o ID canônico quanto o alias anthropic/* são aceitos.

NívelID do modelEntradaSaídaObservações
Opus 4.7anthropic/claude-opus-4-7$5.00$25.00Raciocínio e codificação mais recentes e de mais alta qualidade.
Opus 4.6anthropic/claude-opus-4-6$5.00$25.00Raciocínio e codificação mais recentes e de mais alta qualidade.
Sonnet 4.6anthropic/claude-sonnet-4-6$3.00$15.00Equilíbrio principal entre qualidade e custo (recomendado como padrão).
Haiku 4.5anthropic/claude-haiku-4-5$1.00$5.00O mais rápido e barato da 4ª geração; ótimo para alto QPS e classificação.
Sonnet 4.5anthropic/claude-sonnet-4-5$3.00$15.00Cavalo de batalha geral da geração anterior.
Opus 4.5anthropic/claude-opus-4-5$5.00$25.00Raciocínio e codificação mais recentes e de mais alta qualidade.
Sonnet 4anthropic/claude-4-sonnet$3.00$15.00Cavalo de batalha geral da geração anterior.
Opus 4anthropic/claude-4-opus$15.00$75.00Raciocínio e codificação mais recentes e de mais alta qualidade.
3.5 Sonnetanthropic/claude-3-5-sonnet-latest$3.00$15.00Estável, comprovado em produção; amplamente compatível.
3.5 Haikuanthropic/claude-3-5-haiku-latest$0.80$4.00Estável, comprovado em produção; amplamente compatível.

4Parâmetros da requisição

ParâmetroTipoObrigatórioPadrãoDescrição
modelstringObrigatórioID do model Claude. Exemplo: "anthropic/claude-sonnet-4-6". Tanto o formato com prefixo anthropic/* quanto o nome curto sem prefixo são aceitos.
messagesarrayObrigatórioHistórico do chat. Cada item é { role, content }. role ∈ system | user | assistant. content é uma string ou um array de partes (para visão / resultados de ferramentas).
max_tokensintegerOpcional1024Máximo de tokens de saída (Claude exige isso). Normalmente 1024–4096.
temperaturenumberOpcional1.0Sampling temperature, 0.0–1.0. Lower = more deterministic.
top_pnumberOpcional1.0Amostragem nucleus. Use temperature OU top_p, não ambos.
streambooleanOpcionalfalseSe true, retorna deltas via Server-Sent Events (SSE).
stopstring[]OpcionalAté 4 sequências de parada.
toolsarrayOpcionalLista de definições de ferramenta/função para uso de ferramentas (function calling).
tool_choicestring|objectOpcionalautoControle a seleção de ferramentas: auto | none | required | { type:'function', function:{ name } }.
response_formatobjectOpcionalModo JSON: { "type": "json_object" } força o model a retornar JSON válido.
userstringOpcionalID opcional do usuário final para seu próprio controle.

5Exemplos curl

bash
curl https://tokenhub.store/api/v1/chat/completions \
  -H "Authorization: Bearer th-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4-6",
    "messages": [
      {"role": "system", "content": "You are a concise assistant."},
      {"role": "user", "content": "Explain CAP theorem in 3 bullets."}
    ],
    "max_tokens": 512,
    "temperature": 0.3
  }'

6Exemplo em Python

python
from openai import OpenAI

client = OpenAI(
    api_key="th-your-api-key",
    base_url="https://tokenhub.store/api/v1",
)

resp = client.chat.completions.create(
    model="anthropic/claude-sonnet-4-6",
    max_tokens=512,
    temperature=0.3,
    messages=[
        {"role": "system", "content": "You are a concise assistant."},
        {"role": "user", "content": "Explain CAP theorem in 3 bullets."},
    ],
)

print(resp.choices[0].message.content)
print("usage:", resp.usage)

7Exemplo em JavaScript / Node.js

javascript
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "th-your-api-key",
  baseURL: "https://tokenhub.store/api/v1",
});

const resp = await client.chat.completions.create({
  model: "anthropic/claude-sonnet-4-6",
  max_tokens: 512,
  temperature: 0.3,
  messages: [
    { role: "system", content: "You are a concise assistant." },
    { role: "user", content: "Explain CAP theorem in 3 bullets." },
  ],
});

console.log(resp.choices[0].message.content);
console.log("usage:", resp.usage);

8Dicas de uso

  • Sempre defina max_tokens — Claude o trata como obrigatório semanticamente. Sem ele, gerações longas podem ser truncadas antes do esperado.
  • Coloque as instruções em uma única mensagem system; mantenha as interações do usuário focadas. Claude segue prompts de system com bastante rigor.
  • Para extração estruturada, combine um prompt de system como 'Return only JSON' com response_format: { type: 'json_object' }.
  • Streaming melhora bastante a latência percebida em respostas longas. O formato delta corresponde exatamente ao OpenAI.
  • Haiku-4-5 é ~5× mais barato que Sonnet-4-6, com capacidade semelhante para tarefas curtas — direcione consultas simples para Haiku para economizar custo.
  • Visão: passe imagens como { type: 'image_url', image_url: { url: 'https://...' } } dentro do array content. Data URIs (base64) também são aceitas.

9FAQ

Pronto para começar?

Crie uma conta no TokenHub e comece a chamar Claude via nossa API OpenAI-compatible