🎁 Novo Cadastre-se grátis, 10 chamadas por nossa conta. Até US$ 1, sem cartão.

Início rápido

Comece a usar a Synthorai em menos de 2 minutos.

1. Obtenha sua chave de API

Faça login e acesse Console → Chaves de API. Clique em "Criar chave" e copie-a imediatamente — ela só será exibida uma vez.

2. Faça sua primeira requisição

Escolha o SDK que você já usa. Ambas as receitas acessam o mesmo gateway com a mesma chave de API.

Opção A — SDK da OpenAI

curl https://synthorai.io/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [
      {"role": "user", "content": "Hello! What can you do?"}
    ]
  }'

Opção B — SDK da Anthropic

curl https://synthorai.io/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 256,
    "messages": [
      {"role": "user", "content": "Hello! What can you do?"}
    ]
  }'

O SDK da Anthropic anexa /v1/messages internamente. Use a origem do gateway (sem /v1 como sufixo) base_url — ao contrário do SDK da OpenAI, que usa https://synthorai.io/v1.

3. Liste os modelos disponíveis

curl https://synthorai.io/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Os IDs de modelo seguem o formato usado pelo provedor original. Você pode ver a lista completa com o endpoint /v1/models ou acesse a página Catálogo de modelos .

Usando uma ferramenta em vez de um SDK puro?

Se você estiver conectando a Synthorai ao Claude Code, OpenAI Codex CLI, OpenClaw, Cursor, Continue, Aider ou qualquer outra ferramenta compatível com OpenAI/Anthropic — há uma página de configuração dedicada para cada um dos três principais, além de uma folha de referência de base-URL para todo o resto.

Autenticação

Todas as requisições à API exigem uma chave de API passada no Authorization cabeçalho.

Token Bearer

Authorization: Bearer YOUR_API_KEY

Escopos da chave

ParâmetroTipoDescrição
ReadstringAcesso apenas à lista de modelos e aos dados de uso.
WritestringFazer requisições de inferência (chat, completions).
AdminstringAcesso completo, incluindo o gerenciamento de canais e usuários.

Nunca exponha sua chave de API em código do lado do cliente ou em repositórios públicos. Rotacione as chaves imediatamente se forem comprometidas via Console → Chaves de API.

Formato da chave

As chaves da Synthorai têm o prefixo sk- seguido por uma cadeia aleatória de 32 caracteres. As chaves são armazenadas com hash e não podem ser recuperadas após a criação.

Não sabe por qual modelo começar? Explore a model price comparison para ver lado a lado o preço por token de cada modelo roteável.