Referência da API

A Synthorai expõe uma API REST multiprotocolo sobre HTTPS. A mesma URL base, chave e cobrança atendem a três formatos de requisição — OpenAI Chat Completions, OpenAI Responses e Anthropic Messages — além de endpoints auxiliares para embeddings, imagens, áudio 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)

Endpoints

Endpoint	Tipo	Descrição
`POST /v1/chat/completions`	`chat`	OpenAI Chat Completions — ponto de entrada universal, roteia para qualquer provedor.
`POST /v1/responses`	`chat`	OpenAI Responses — uso de ferramentas, raciocínio, saída estruturada.
`POST /v1/messages`	`chat`	Anthropic Messages — nativo Claude / Bedrock-Anthropic.
`POST /v1/embeddings`	`embedding`	Gera embeddings vetoriais.
`POST /v1/images/generations`	`image`	Gera imagens a partir de prompts de texto.
`POST /v1/videos`	`video`	Criar e fazer polling de jobs assíncronos de geração de vídeo.
`POST /v1/audio/transcriptions`	`audio`	Transcreve áudio em texto.
`POST /v1/audio/speech`	`audio`	Converte texto em fala.
`POST /v1/rerank`	`rerank`	Reordena documentos em relação a uma consulta.
`GET /v1/models`	`read`	Lista todos os modelos disponíveis para a chave autenticada.

Cada endpoint é cobrado pelo mesmo catálogo por token — veja a model price comparison para saber quanto custa cada modelo roteável.