Referencia de la API

Synthorai expone una API REST multiprotocolo sobre HTTPS. La misma URL base, clave y facturación dan servicio a tres formatos de solicitud - OpenAI Chat Completions, OpenAI Responses y Anthropic Messages - además de endpoints auxiliares para embeddings, imágenes, audio y 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)

Endpoints

Endpoint	Tipo	Descripción
`POST /v1/chat/completions`	`chat`	OpenAI Chat Completions - punto de entrada universal, enruta a cualquier proveedor.
`POST /v1/responses`	`chat`	OpenAI Responses - uso de herramientas, razonamiento, salida estructurada.
`POST /v1/messages`	`chat`	Anthropic Messages - nativo de Claude / Bedrock-Anthropic.
`POST /v1/embeddings`	`embedding`	Genera embeddings vectoriales.
`POST /v1/images/generations`	`image`	Genera imágenes a partir de prompts de texto.
`POST /v1/videos`	`video`	Crear y sondear jobs asíncronos de generación de vídeo.
`POST /v1/audio/transcriptions`	`audio`	Transcribe audio a texto.
`POST /v1/audio/speech`	`audio`	Convierte texto en voz.
`GET /v1/models`	`read`	Lista todos los modelos disponibles para la clave autenticada.
`/api/v1/keys`	`keys`	Crea, lista, cambia, rota y elimina claves de inferencia desde tu propio código (requiere una clave de administración con keys.read o keys.write).
`GET /api/v1/requests`	`logs`	Lista y lee las solicitudes del espacio de trabajo: modelo, clave, tokens, coste, tiempos y etiquetas, nunca el prompt ni la respuesta (requiere una clave de administración con logs.read).
`/api/v1/prompts`	`prompts`	Lee y modifica la biblioteca de prompts desde tu propio código: prompts, versiones, etiquetas y despliegues, además de conjuntos de pruebas y ejecuciones de evaluación (requiere una clave de administración con prompts.read o prompts.write; evals.read o evals.write para las pruebas).
`GET /api/v1/audit-logs`	`workspace`	Lee cómo está configurado el espacio de trabajo y qué se ha cambiado en él: registro de auditoría, miembros e invitaciones, ajustes de BYOK y destinos de exportación, cada uno con su propio ámbito de lectura. Nunca se devuelve ninguna credencial.
`GET /api/v1/billing/*`	`billing`	Datos de solo lectura de uso, coste y frescura para tu propio espacio de trabajo (requiere una clave de facturación, no una clave API normal).
`POST /v1/mcp`	`mcp`	Servidor MCP: todos los modelos, la gestión de claves API y los datos de facturación como herramientas para agentes de IA (Claude Code, Cursor, Codex…), con tu clave API.

Cada endpoint se factura con el mismo catálogo por token; consulta la model price comparison para ver cuánto cuesta cada modelo enrutable.