🎁 Novità Registrati gratis, 10 chiamate le offriamo noi. Fino a $1, senza carta.

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?"}
    ]
  }'

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?"}
    ]
  }'

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

ParametroTipoDescrizione
ReadstringAccesso solo all'elenco modelli e ai dati di utilizzo.
WritestringEsecuzione di richieste di inferenza (chat, completions).
AdminstringAccesso 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.