Como chamar a Claude API no seu código
Mude duas coisas no seu código: a Base URL passa a ser https://api.relayswitch.io/v1 e a API key passa a ser a chave da RelaySwitch. O SDK da Anthropic e o SDK da OpenAI funcionam sem nenhuma outra alteração, com 13 modelos Claude cujos preços são lidos direto do catálogo.
01O que muda em relação a chamar a Anthropic diretamente
Usar a Claude API diretamente significa abrir uma conta no Console da Anthropic, adicionar créditos lá e chamar com uma chave de lá. Aqui essa parte é substituída: você recarrega o saldo na RelaySwitch, usa a chave da RelaySwitch, e a requisição vai para o gateway, que a encaminha ao modelo. Para o seu código, só mudam a Base URL e a chave; o corpo da requisição, o id do modelo, o streaming e o tool calling continuam iguais.
A cobrança é por token, com três preços: entrada, entrada em cache e saída. O preço da tabela é o preço debitado do saldo.
Cada resposta traz o id da requisição no header. Com esse id você obtém o recibo assinado, que registra o id do modelo, os tokens cobrados e o custo.
02Primeira requisição com curl
Confirme com curl que a chave e o endereço estão corretos antes de levá-los para o SDK.
A chave pode ir no header x-api-key ou em Authorization: Bearer, mas cada requisição só pode levar uma chave. Para streaming, defina stream como true; a resposta chega como server-sent events.
curl -i https://api.relayswitch.io/v1/messages \ -H "Authorization: Bearer sk-relay-..." \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{"model": "claude-fable-5.1", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with ok"}]}'03SDK da Anthropic para Python
Código novo, ou código que usa recursos próprios do Claude, como o campo system, a estrutura nativa de tool use e os marcadores de prompt cache, fica melhor com o SDK da Anthropic em /messages. Basta preencher base_url e api_key.
O SDK da Anthropic acrescenta /v1/messages por conta própria ao final da Base URL. O gateway aceita o /v1 repetido, por isso todos os exemplos usam https://api.relayswitch.io/v1.
import anthropic client = anthropic.Anthropic(base_url="https://api.relayswitch.io/v1", api_key="sk-relay-...")reply = client.messages.create( model="claude-fable-5.1", max_tokens=300, messages=[{"role": "user", "content": "Reply with ok"}],)print(reply.content[0].text)print(reply.usage)04SDK da OpenAI: o código antigo não precisa ser refeito
Se a sua aplicação já foi escrita no formato OpenAI, ou se o mesmo código também chama modelos de outros desenvolvedores, use /chat/completions e troque model por um id de Claude. Os dois formatos usam a mesma chave, o mesmo saldo e o mesmo preço.
Exemplos para outros SDKs e frameworks estão na documentação e nos guias por ferramenta, ambos em inglês. Para o Claude Code, veja a página Claude Code.
from openai import OpenAI client = OpenAI(base_url="https://api.relayswitch.io/v1", api_key="sk-relay-...")reply = client.chat.completions.create( model="claude-fable-5.1", messages=[{"role": "user", "content": "Reply with ok"}],)print(reply.choices[0].message.content)05Preços atuais dos modelos Claude
Em USD por milhão de tokens, lidos do catálogo quando a página é renderizada. Tokens que caem no prompt cache, como um system prompt longo, documentos enviados repetidamente e o histórico de conversas com vários turnos, são cobrados pelo preço de entrada em cache, menor que o preço de entrada. O recibo de cada requisição separa tokens de entrada, de entrada em cache e de saída, então dá para conferir um a um.
| Modelo | Desenvolvedor | Entrada | Saída | Contexto |
|---|---|---|---|---|
| Claude Fable 5.1claude-fable-5.1 | Anthropic | $6.00 | $30.00 | 1,000,000 |
| Claude Fable 5.2claude-fable-5.2 | Anthropic | $4.00 | $20.00 | 1,000,000 |
| Claude Fable 5claude-fable-5 | Anthropic | $3.00 | $15.00 | 1,000,000 |
| Claude Opus 5.5claude-opus-5-5 | Anthropic | $2.716 | $9.70 | 1,000,000 |
| Claude Sonnet 4.6claude-sonnet-4-6 | Anthropic | $1.80 | $9.00 | 1,000,000 |
| Claude Opus 4.6claude-opus-4-6 | Anthropic | $1.80 | $7.50 | 1,000,000 |
| Claude Opus 4.7claude-opus-4-7 | Anthropic | $1.80 | $7.50 | 1,000,000 |
| Claude Opus 4.8claude-opus-4-8 | Anthropic | $1.80 | $7.50 | 1,000,000 |
| Claude Opus 5claude-opus-5 | Anthropic | $1.80 | $7.50 | 1,000,000 |
| Claude Haiku 4.5claude-haiku-4-5 | Anthropic | $0.60 | $3.00 | 200,000 |
| Claude Sonnet 5claude-sonnet-5 | Anthropic | $1.20 | $3.00 | 1,000,000 |
| Claude Sonnet 5.5claude-sonnet-5-5 | Anthropic | $1.20 | $3.00 | 1,000,000 |
| Claude Haiku 5.5claude-haiku-5-5 | Anthropic | $0.0582 | $0.1455 | 1,000,000 |
USD por milhão de tokens
06Códigos de erro mais comuns
Os status 401 a 404 são devolvidos antes de a requisição chegar ao modelo, e 429, 502 e 503 não trazem resposta; nenhum deles é cobrado. O corpo do erro segue a estrutura de erro do formato que você usa.
401 invalid_api_key | A chave não foi enviada, está errada ou foi revogada. |
402 insufficient_balance | Saldo insuficiente. Orçamento ou limite de gasto esgotado na chave tem código de erro próprio. |
403 scope_denied | O id do modelo não está na allowlist dessa chave. |
404 model_not_found | O id do modelo não existe no catálogo; em geral é erro de digitação. |
429 rate_limited | O rate limit da chave foi atingido; o header retry-after informa quantos segundos esperar. |
| 502 / 503 | A rota até o modelo está com problema, ou por enquanto nenhuma rota responde. |
07Antes de ir para produção
Crie uma chave separada para produção e configure o que for necessário: orçamento, limite de gasto diário, allowlist de modelos e allowlist de IPs. Por padrão cada chave é limitada a 200 requisições por minuto, e esse número pode ser alterado na própria chave. Em requisições que falham, leia o header retry-after antes de tentar de novo e guarde nos seus logs o id da requisição que vem na mensagem de erro, porque ele ajuda na investigação de problemas.
Um mesmo id de modelo é atendido por várias rotas. Se uma rota responde 5xx ou 429, a requisição passa automaticamente para a rota seguinte, pelo mesmo preço; um modelo com apenas uma rota responde 503.
Perguntas frequentes
- Formato Anthropic ou formato OpenAI?
- Os dois funcionam, com a mesma chave e a mesma Base URL (https://api.relayswitch.io/v1). O SDK da Anthropic usa /messages, o SDK da OpenAI usa /chat/completions, e o id do modelo Claude é escrito exatamente igual nos dois.
- A Base URL precisa ter /v1?
- Sim. Preencha https://api.relayswitch.io/v1, e o SDK acrescenta /messages ou /chat/completions por conta própria.
- Streaming é suportado?
- Sim. Defina stream: true na requisição, e a resposta chega como server-sent events. Todos os modelos suportam streaming.
- Como garantir que o modelo chamado é mesmo o Claude, e não outro?
- Há duas formas que não exigem que você confie nesta página. Cada modelo recebe o mesmo prompt de teste uma vez por dia e a resposta é comparada com os resultados anteriores; o resultado fica aberto em https://api.relayswitch.io/v1/proof. Cada requisição também tem um recibo assinado (GET https://api.relayswitch.io/v1/requests/:id/receipt) com o id do modelo, os tokens cobrados e o custo, que pode ser verificado offline com a chave pública.
- Requisições que falham são cobradas?
- Requisições que falham antes de chegar ao modelo, ou que o modelo não responde, não são cobradas. Isso inclui os status 401 a 404 e também 429, 502 e 503.
- Como recarregar, e é preciso KYC?
- Com cartão ou USDT, USDC, BTC, ETH, SOL, a partir de $10. O saldo é registrado em dólares americanos, não expira, e não há assinatura. A conta é aberta com um e-mail, sem verificação de identidade.
Troque uma linha: base_url
Base URL https://api.relayswitch.io/v1, modelos Claude cobrados por token pelo preço do catálogo, com verificação diária aberta ao público.