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. |
POST /v1/rerank | rerank | Esegue il rerank dei documenti rispetto a una query. |
GET /v1/models | read | Elenca tutti i modelli disponibili per la chiave autenticata. |
Ogni endpoint viene fatturato sullo stesso catalogo per token — consulta il model price comparison per sapere quanto costa ogni modello instradabile.