API-Referenz

Synthorai stellt eine Multiprotokoll-REST-API über HTTPS bereit. Dieselbe Basis-URL, derselbe Schlüssel und dieselbe Abrechnung bedienen drei Anfrageformen - OpenAI Chat Completions, OpenAI Responses und Anthropic Messages - sowie zusätzliche Endpunkte für Embeddings, Bilder, Audio und 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)

Endpunkte

Endpoint	Typ	Beschreibung
`POST /v1/chat/completions`	`chat`	OpenAI Chat Completions - universeller Einstiegspunkt, leitet an jeden Provider weiter.
`POST /v1/responses`	`chat`	OpenAI Responses - Tool-Nutzung, Reasoning, strukturierte Ausgabe.
`POST /v1/messages`	`chat`	Anthropic Messages - Claude / Bedrock-Anthropic nativ.
`POST /v1/embeddings`	`embedding`	Generiert Vektor-Embeddings.
`POST /v1/images/generations`	`image`	Generiert Bilder aus Text-Prompts.
`POST /v1/videos`	`video`	Asynchrone Videogenerierungs-Jobs anlegen und pollen.
`POST /v1/audio/transcriptions`	`audio`	Transkribiert Audio in Text.
`POST /v1/audio/speech`	`audio`	Wandelt Text in Sprache um.
`GET /v1/models`	`read`	Listet alle für den authentifizierten Schlüssel verfügbaren Modelle auf.
`/api/v1/keys`	`keys`	Inferenzschlüssel aus Ihrem eigenen Code anlegen, auflisten, ändern, rotieren und löschen (erfordert einen Admin-Schlüssel mit keys.read oder keys.write).
`GET /api/v1/requests`	`logs`	Anfragen des Workspace auflisten und lesen: Modell, Schlüssel, Tokens, Kosten, Zeiten und Labels, nie der Prompt oder die Antwort (erfordert einen Admin-Schlüssel mit logs.read).
`/api/v1/prompts`	`prompts`	Prompt-Bibliothek aus dem eigenen Code lesen und ändern: Prompts, Versionen, Labels und schrittweise Einführungen sowie Testsets und Eval-Läufe (erfordert einen Admin-Schlüssel mit prompts.read oder prompts.write; für die Tests evals.read oder evals.write).
`GET /api/v1/audit-logs`	`workspace`	Lesen, wie der Workspace eingerichtet ist und was daran geändert wurde: Audit-Log, Mitglieder und Einladungen, BYOK-Einstellungen und Exportziele, jeweils mit eigenem Lese-Scope. Zugangsdaten werden nie zurückgegeben.
`GET /api/v1/billing/*`	`billing`	Nur lesende Nutzungs-, Kosten- und Aktualitätsdaten für Ihren eigenen Workspace (erfordert einen Billing-Schlüssel, keinen regulären API-Schlüssel).
`POST /v1/mcp`	`mcp`	MCP-Server: alle Modelle, API-Schlüsselverwaltung und Abrechnungsdaten als Tools für KI-Agenten (Claude Code, Cursor, Codex …), mit Ihrem API-Schlüssel.

Jeder Endpunkt wird nach demselben Token-Preiskatalog abgerechnet - im model price comparison sehen Sie, was jedes routbare Modell kostet.