Avvio rapido
Inizia a usare Synthorai in meno di 2 minuti.
1. Ottieni la tua chiave API
Accedi e vai a Console → Chiavi API. Clicca "Crea chiave" e copiala subito — verrà mostrata una sola volta.
2. Effettua la tua prima richiesta
Scegli l'SDK che già usi. Entrambe le ricette raggiungono lo stesso gateway con la stessa chiave API.
Opzione A — SDK 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);Opzione B — SDK 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);L'SDK Anthropic aggiunge /v1/messages internamente. Usa l'origin del gateway (senza il suffisso /v1 ) come base_url — a differenza dell'SDK OpenAI, che accetta https://synthorai.io/v1.
3. Elenca i modelli disponibili
curl https://synthorai.io/v1/models \
-H "Authorization: Bearer YOUR_API_KEY" Gli ID dei modelli seguono il formato del provider originale. Puoi scoprire l'elenco completo con l'endpoint /v1/models oppure visitare la pagina Catalogo modelli .
Usi uno strumento invece di un SDK diretto?
Se stai collegando Synthorai a Claude Code, OpenAI Codex CLI, OpenClaw, Cursor, Continue, Aider o qualsiasi altro strumento compatibile OpenAI/Anthropic — c'è una pagina di configurazione dedicata per ciascuno dei tre principali, più un cheat sheet degli URL di base per tutto il resto.
Autenticazione
Tutte le richieste API richiedono una chiave API passata nell'header Authorization .
Bearer Token
Authorization: Bearer YOUR_API_KEY Scope della chiave
| Parametro | Tipo | Descrizione |
|---|---|---|
Read | string | Accesso solo all'elenco modelli e ai dati di utilizzo. |
Write | string | Esecuzione di richieste di inferenza (chat, completions). |
Admin | string | Accesso completo, inclusa la gestione di canali e utenti. |
Non esporre mai la chiave API in codice client-side o repository pubblici. In caso di compromissione, ruota subito le chiavi da Console → Chiavi API.
Formato della chiave
Le chiavi Synthorai hanno il prefisso sk- seguito da una stringa casuale di 32 caratteri. Le chiavi sono sottoposte a hashing a riposo e non possono essere recuperate dopo la creazione.
Non sai da quale modello iniziare? Sfoglia il model price comparison per confrontare fianco a fianco il prezzo per token di ogni modello instradabile.