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?"}
]
}'from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://synthorai.io/v1"
)
response = client.chat.completions.create(
model="gpt-5.4-mini",
messages=[{"role": "user", "content": "Hello! What can you do?"}]
)
print(response.choices[0].message.content)import OpenAI from "openai";
const client = new OpenAI({
apiKey: "YOUR_API_KEY",
baseURL: "https://synthorai.io/v1",
});
const response = await client.chat.completions.create({
model: "gpt-5.4-mini",
messages: [{ role: "user", content: "Hello! What can you do?" }],
});
console.log(response.choices[0].message.content);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?"}
]
}'from anthropic import Anthropic
client = Anthropic(
api_key="YOUR_API_KEY",
base_url="https://synthorai.io"
)
message = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=256,
messages=[{"role": "user", "content": "Hello! What can you do?"}]
)
print(message.content[0].text)import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
apiKey: "YOUR_API_KEY",
baseURL: "https://synthorai.io",
});
const message = await client.messages.create({
model: "claude-sonnet-4-6",
max_tokens: 256,
messages: [{ role: "user", content: "Hello! What can you do?" }],
});
console.log(message.content[0].text);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âmetro | Tipo | Descrição |
|---|---|---|
Read | string | Acesso apenas à lista de modelos e aos dados de uso. |
Write | string | Fazer requisições de inferência (chat, completions). |
Admin | string | Acesso 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.