Riferimento API

Synthorai espone un'API REST multi-protocollo su HTTPS. Stessi base URL, chiave e fatturazione per tre formati di richiesta - OpenAI Chat Completions, OpenAI Responses e Anthropic Messages - più endpoint ausiliari per embedding, immagini, audio e reranking.

Base URL:  https://synthorai.io/v1

All endpoints require:
  Content-Type:  application/json
  Authorization: Bearer <your-api-key>
  (or x-api-key: <your-api-key> for /v1/messages)

Endpoint

Endpoint	Tipo	Descrizione
`POST /v1/chat/completions`	`chat`	OpenAI Chat Completions - punto di ingresso universale, instrada verso qualsiasi provider.
`POST /v1/responses`	`chat`	OpenAI Responses - tool use, reasoning, output strutturato.
`POST /v1/messages`	`chat`	Anthropic Messages - nativo Claude / Bedrock-Anthropic.
`POST /v1/embeddings`	`embedding`	Genera embedding vettoriali.
`POST /v1/images/generations`	`image`	Genera immagini da prompt testuali.
`POST /v1/videos`	`video`	Crea e interroga job asincroni di generazione video.
`POST /v1/audio/transcriptions`	`audio`	Trascrive audio in testo.
`POST /v1/audio/speech`	`audio`	Converte testo in voce.
`GET /v1/models`	`read`	Elenca tutti i modelli disponibili per la chiave autenticata.
`/api/v1/keys`	`keys`	Crea, elenca, modifica, ruota ed elimina le chiavi di inferenza dal tuo codice (richiede una chiave di amministrazione con keys.read o keys.write).
`GET /api/v1/requests`	`logs`	Elenca e leggi le richieste del workspace: modello, chiave, token, costo, tempi ed etichette, mai il prompt né la risposta (richiede una chiave di amministrazione con logs.read).
`/api/v1/prompts`	`prompts`	Leggi e modifica la libreria dei prompt dal tuo codice: prompt, versioni, etichette e rilasci graduali, oltre a set di test e valutazioni (richiede una chiave di amministrazione con prompts.read o prompts.write; evals.read o evals.write per i test).
`GET /api/v1/audit-logs`	`workspace`	Leggi come è configurato il workspace e che cosa vi è stato modificato: registro di audit, membri e inviti, impostazioni BYOK e destinazioni di esportazione, ciascuno con un proprio ambito di lettura. Nessuna credenziale viene mai restituita.
`GET /api/v1/billing/*`	`billing`	Dati di sola lettura su uso, costo e freschezza per il tuo workspace (richiede una chiave di fatturazione, non una chiave API normale).
`POST /v1/mcp`	`mcp`	Server MCP: tutti i modelli, la gestione delle chiavi API e i dati di fatturazione come strumenti per gli agenti AI (Claude Code, Cursor, Codex…), con la tua chiave API.

Ogni endpoint viene fatturato sullo stesso catalogo per token - consulta il model price comparison per sapere quanto costa ogni modello instradabile.