Référence API

Synthorai expose une API REST multiprotocole via HTTPS. La même URL de base, la même clé et la même facturation servent trois formes de requêtes - OpenAI Chat Completions, OpenAI Responses et Anthropic Messages - ainsi que des points de terminaison auxiliaires pour les embeddings, les images, l'audio et le 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)

Points de terminaison

Point de terminaison	Type	Description
`POST /v1/chat/completions`	`chat`	OpenAI Chat Completions - point d'entrée universel, route vers n'importe quel provider.
`POST /v1/responses`	`chat`	OpenAI Responses - utilisation d'outils, raisonnement, sortie structurée.
`POST /v1/messages`	`chat`	Anthropic Messages - natif Claude / Bedrock-Anthropic.
`POST /v1/embeddings`	`embedding`	Génère des embeddings vectoriels.
`POST /v1/images/generations`	`image`	Génère des images à partir d'invites textuelles.
`POST /v1/videos`	`video`	Créer et suivre des jobs asynchrones de génération de vidéos.
`POST /v1/audio/transcriptions`	`audio`	Transcrit l'audio en texte.
`POST /v1/audio/speech`	`audio`	Convertit le texte en parole.
`GET /v1/models`	`read`	Liste tous les modèles disponibles pour la clé authentifiée.
`/api/v1/keys`	`keys`	Créez, listez, modifiez, renouvelez et supprimez des clés d’inférence depuis votre code (nécessite une clé d’administration avec keys.read ou keys.write).
`GET /api/v1/requests`	`logs`	Listez et lisez les requêtes de l’espace de travail : modèle, clé, tokens, coût, durées et libellés, jamais le prompt ni la réponse (nécessite une clé d’administration avec logs.read).
`/api/v1/prompts`	`prompts`	Lisez et modifiez la bibliothèque de prompts depuis votre code : prompts, versions, étiquettes et déploiements progressifs, ainsi que les jeux de tests et les évaluations (nécessite une clé d’administration avec prompts.read ou prompts.write ; evals.read ou evals.write pour les tests).
`GET /api/v1/audit-logs`	`workspace`	Lisez la configuration de l’espace de travail et ce qui y a été modifié : journal d’audit, membres et invitations, réglages BYOK et destinations d’export, chacun avec sa propre portée de lecture. Aucun identifiant n’est jamais renvoyé.
`GET /api/v1/billing/*`	`billing`	Données en lecture seule d'usage, de coût et de fraîcheur pour votre propre workspace (nécessite une clé de facturation, pas une clé API classique).
`POST /v1/mcp`	`mcp`	Serveur MCP : tous les modèles, la gestion des clés API et les données de facturation exposés comme outils pour les agents IA (Claude Code, Cursor, Codex…), avec votre clé API.

Chaque endpoint est facturé sur le même catalogue au token - consultez le model price comparison pour connaître le coût de chaque modèle routable.